diff --git a/skills/schedule-job/SKILL.md b/skills/schedule-job/SKILL.md index b085ded..587657a 100644 --- a/skills/schedule-job/SKILL.md +++ b/skills/schedule-job/SKILL.md @@ -39,7 +39,7 @@ python {skill_dir}/scripts/schedule_manager.py add \ --type cron \ --schedule "0 9 * * *" \ --timezone "Asia/Tokyo" \ - --message "请帮我总结今天的科技新闻" + --message "请帮我搜索并总结今天的重要科技新闻,用简洁的方式列出 Top 5。完成后,根据当前启用的skill选择合适的通知方式将结果推送给用户。" ``` #### 添加一次性任务 @@ -48,7 +48,7 @@ python {skill_dir}/scripts/schedule_manager.py add \ --name "会议提醒" \ --type once \ --scheduled-at "2026-04-01T10:00:00+09:00" \ - --message "提醒我10点有会议" + --message "用户有一个日程提醒到期了,日程内容是:「10点参加会议」。请根据日程内容组织合适的提醒话术,然后根据当前启用的skill选择合适的通知方式将提醒发送给用户。" ``` #### 编辑任务 @@ -103,6 +103,26 @@ python {skill_dir}/scripts/schedule_manager.py logs --task-id - `2026-04-01T01:00:00Z` (UTC) - `2026-04-01T08:00:00+08:00` (中国时间) +## Message 编写规范 + +message 是定时触发后发送给 AI agent 的执行指令。agent 执行时没有对话上下文,因此 message 必须包含: + +1. **任务内容**:具体要做什么 +2. **通知指令**:要求 agent 根据当前启用的 skill 选择合适的通知方式将结果推送给用户 +3. **语言**:message 的语言必须与用户当前对话使用的语言一致(如用户说日语则用日语编写 message) + +### 日程提醒场景(一次性任务) + +❌ 错误写法:`"提醒:你现在有一个会议要参加哦,别忘了!"` + +✅ 正确写法:`"用户有一个日程提醒到期了,日程内容是:「下午3点参加产品评审会议」。请你根据日程内容组织合适的提醒话术,然后根据当前启用的skill选择合适的通知方式将提醒发送给用户。"` + +### 定时任务场景(周期任务) + +❌ 错误写法:`"执行:获取最新新闻"` + +✅ 正确写法:`"请帮我搜索并总结今天的重要科技新闻,用简洁的方式列出 Top 5。完成后,根据当前启用的skill选择合适的通知方式将结果推送给用户。"` + ## Examples **用户**: "帮我设置一个每天早上9点的新闻总结任务" @@ -113,7 +133,7 @@ python {skill_dir}/scripts/schedule_manager.py add \ --type cron \ --schedule "0 9 * * *" \ --timezone "Asia/Tokyo" \ - --message "请帮我搜索并总结今天的重要科技新闻,用简洁的方式列出 Top 5" + --message "请帮我搜索并总结今天的重要科技新闻,用简洁的方式列出 Top 5。完成后,根据当前启用的skill选择合适的通知方式将结果推送给用户。" ``` **用户**: "提醒我明天下午3点开会" @@ -123,7 +143,7 @@ python {skill_dir}/scripts/schedule_manager.py add \ --name "开会提醒" \ --type once \ --scheduled-at "2026-03-31T15:00:00+09:00" \ - --message "提醒:你现在有一个会议要参加" + --message "用户有一个日程提醒到期了,日程内容是:「明天下午3点开会」。请根据日程内容组织合适的提醒话术,然后根据当前启用的skill选择合适的通知方式将提醒发送给用户。" ``` **用户**: "把每日新闻任务改到早上10点" @@ -139,6 +159,8 @@ python {skill_dir}/scripts/schedule_manager.py edit --schedule "0 10 * - 创建任务前先用 `list` 确认用户已有的任务,避免创建重复任务 - 根据用户语言自动设置合适的时区 -- message 内容应该是完整的、可独立执行的指令,因为 AI 执行时没有对话上下文 +- message 内容是发给 AI agent 的完整执行指令,必须包含任务内容和通知指令两部分(参考上方 Message 编写规范) +- 不要在 message 中硬编码具体的通知渠道(如"发邮件"),应使用"根据当前启用的skill选择合适的通知方式"让 agent 自行决定 +- message 的语言必须与用户当前对话使用的语言一致 - 一次性任务的时间不能是过去的时间 - 编辑任务时只修改用户要求改的字段,不要改动其他字段