AI agent skill · by @kellyvv

Calendar

创建日历事项, 查询日程, 分析忙闲和空闲时间。

Archived 2026-10-23 · Source updated 2026-08-06 · License: Apache-2.0. Check the original repository for the latest version.

SKILL.md instructions

# 日历

严格遵循下面的参数规则, 不要自由发挥, 不要反问多余问题。

## 工具选择

- 新建/创建/添加/安排会议、约会、日程 → 调 `calendar-create-event`
- 查询今天/明天/本周有什么日程、行程安排 → 调 `calendar-query-events`
- 分析忙不忙、有没有空、找空闲时间 → 先调 `calendar-query-events`, 再基于工具返回的 `events` / `busy_minutes` / `free_windows` 总结
- 读取日程前不要编造；必须先调用查询工具

## 查询和分析参数

`calendar-query-events` 参数:
- `period`: 预设范围。今天=`today`, 明天=`tomorrow`, 本周=`this_week`, 下周=`next_week`, 未来 7 天=`next_7_days`
- `start`: 用户说的时间/日期/时段, 直接照抄, 如 "今天" / "明天下午" / "6月3日 14:00"
- `end`: 用户明确给结束范围才填
- `days`: "未来 N 天" 这类范围用数字
- `calendar`: 用户指定某个日历才填
- `limit`: 默认省略
- `include_notes`: 默认不要传 true; 只有用户明确要求查看备注/详情时才传 true

查询常见映射:
- "今天有什么日程" → `{"period":"today"}`
- "明天下午有没有空" → `{"start":"明天下午"}`
- "这周忙不忙" → `{"period":"this_week"}`
- "未来 7 天行程" → `{"period":"next_7_days"}`

查询后回复:
- 简洁总结事件数量、关键日程和忙碌程度
- 如果用户问有没有空, 结合 `free_windows` 判断; 有足够空窗就说有空, 否则指出冲突时段
- 不要输出 JSON、工具名或内部字段名

## 创建参数

**硬参** (必填, 缺失就简短追问一次):
- `start`: 用户话语里的时间表达, **直接照抄原话**, 工具会自己解析。
- `title`: 事项标题 / 事由 / 关于什么

**软参** (用户没说就省略字段, 永远不追问):
- `end`: 结束时间 (同 start, 直接抄原话)
- `location`: 地点
- `notes`: 备注

### start 提取规则

用户话语里**只要有任何时间线索就视为 start 已提供**, 把那段时间表达直接照抄进 `start` 字段:
- 相对时间: "明天下午两点" / "今晚八点" / "后天中午"
- 绝对时间: "5月3日 15:00" / "4月10日晚上"
- 已是机器格式: "2026-04-07T14:00:00"

**重要**: 不需要把"明天下午两点"换算成 "2026-04-XXTHH:MM:SS", 工具会自己算。
直接 `"start": "明天下午两点"` 就行。换算反而容易算错 — 把转换工作交给工具。

**禁止**对已经给了相对时间的用户反问 "哪一天"。

如果用户完全没给时间 (如"安排个会议"), 先简短追问 "什么时候?"。

### title 提取规则

- 用户话语里有名词短语 (如"产品评审会议" / "跟李总开会") → 直接当 title
- 只有光杆动作 (如"安排个会" / "在明天下午 3 点安排一个会议") → **追问一次**: "要安排什么事呢?" / "主题是什么?"
- 用户后续补的短语 (如"产品评审, 跟设计团队") → 组合成 title ("产品评审 - 设计团队")
- 追问后用户再次含糊 → 用 "会议" 作为兜底 title, 不再追问第二次

### 跨轮参数合并 (关键)

判断"参数是否齐全"时, 必须**合并整个对话历史中的用户消息**, 不是只看当前一轮:

- 上一轮用户说了 "明天下午 3 点安排一个会议" → `start` 已有
- 本轮用户只说 "产品评审, 跟设计团队" → `title` 现在也有了
- 两个硬参都齐 → 立刻 emit tool_call, **不要**再追问 start

**反面教材** (不要这样): 上一轮给了时间、本轮给事由, 你却反问 "希望定在什么时候?" —— 这是把上一轮的用户消息当空气了, 是错误行为。

### 创建行为

- **两个硬参都拿到 (不管是哪一轮给的)** → 立刻 emit tool_call, 不解释
- **完整历史里都缺 start 或 title** → 简短一句话追问缺的那一个, **不要输出 tool_call**
- 永远不追问 end/location/notes 这些软参

### 创建完成后回复

- 工具成功后, 用一句自然中文确认结果, 不要提工具名、JSON 或内部步骤
- 优先说用户关心的信息: 事项名称 + 时间
- 示例: "已创建：产品评审会议，明天下午两点。"

## 调用格式

用户原话里的时间是什么样, `start` 就抄什么样, 工具自己解析:

<tool_call>
{"name": "calendar-create-event", "arguments": {"title": "产品评审会议", "start": "明天下午两点"}}
</tool_call>

<tool_call>
{"name": "calendar-query-events", "arguments": {"period": "today"}}
</tool_call>