定时任务 Skill
⚠️ 核心原则
原则一：优先修改已有任务
当用户说"修改/更改/调整某个定时任务"时，绝对不要创建新任务。 正确流程：① 列出任务 → ② 找到目标任务 ID → ③ 调用 update 脚本修改
原则二：IM 发送 = 通知平台，不是 prompt
当用户说"发到钉钉/飞书/企业微信/Telegram/Discord"时，这是通知投递需求，应设置notifyPlatforms字段，不要写进prompt。 任务完成后，系统会自动将 Claude 的执行结果发送到指定 IM 平台，无需在 prompt 中额外指示"发送到 XX"。 正确做法： -prompt:"查询今天的天气并整理成报告"— 只描述要执行的动作 -notifyPlatforms:["dingtalk"]— 系统自动把结果发到钉钉 错误做法： -prompt:"查询今天的天气并发送到钉钉群"— ❌ 不要把 IM 发送写进 prompt 常见触发词映射： | 用户说的 | 对应 notifyPlatforms 值 | | --- | --- | | 发到钉钉/钉钉群/DingTalk |"dingtalk"| | 发到飞书/Lark |"feishu"| | 发到QQ/QQ群/QQ机器人 |"qq"| | 发到 Telegram/TG/电报 |"telegram"| | 发到 Discord |"discord"| | 发到企业微信/WeCom |"wecom"| | 发到云信/网易云信/NIM |"nim"| | 发到小蜜蜂/Xiaomifeng |"xiaomifeng"|
原则三：从用户自然语言中正确提取各字段
用户通常一句话包含所有意图。你需要将其拆解为定时任务的各个字段，不要把所有内容都塞进 prompt。字段提取映射：
| 用户描述中的成分 | 对应字段 | 提取方式 |
|---|---|---|
| 时间/频率（每天9点、周一、每30分钟…） | schedule | 转换为 cron/at/interval |
| 要做的事情（核心动作） | prompt | 展开为完整独立指令（见下方 prompt 编写规范） |
| 发到某个 IM（钉钉、飞书、TG…） | notifyPlatforms | 映射为平台数组（见原则二），不要写进 prompt |
| 任务简称（可从动作推断） | name | 提炼简短名称 |
| 涉及特定目录/项目 | workingDirectory | 提取目录路径 |
| 到期/截止（只跑到月底、到3月为止…） | expiresAt | 转换为 "YYYY-MM-DD" |
| 执行环境（在沙箱里跑…） | executionMode | "sandbox" / "local" |
完整拆解示例：
示例 1：用户说 "每天早上9点帮我查一下AI新闻发到钉钉"
{
"name": "每日AI新闻播报",
"schedule": { "type": "cron", "expression": "0 9 * * *" },
"prompt": "请搜索并整理今天最重要的 AI 领域新闻（不少于 5 条），每条包含标题、来源和一句话摘要。按重要性排序，输出为清晰的列表格式。",
"notifyPlatforms": ["dingtalk"]
}注意：prompt中没有"发到钉钉"——IM 发送由notifyPlatforms处理。
示例 2：用户说 "工作日下午6点跑一下项目测试，结果发飞书"
{
"name": "工作日项目测试",
"schedule": { "type": "cron", "expression": "0 18 * * 1-5" },
"prompt": "在当前项目目录下执行完整的测试套件（npm test 或对应的测试命令），收集测试结果。输出测试通过/失败的统计摘要，列出所有失败的测试用例及其错误信息。",
"notifyPlatforms": ["feishu"]
}示例 3：用户说 "每周一早上8点总结上周的Git提交"
{
"name": "周报-Git提交总结",
"schedule": { "type": "cron", "expression": "0 8 * * 1" },
"prompt": "执行 git log 查看过去 7 天的所有提交记录。按作者分组统计提交数量，列出每位作者的主要变更摘要。最后给出整体项目进展的简要总结。"
}注意：用户没提 IM，所以没有 notifyPlatforms。示例 4：用户说 "5分钟后提醒我开会"
{
"name": "开会提醒",
"schedule": { "type": "at", "datetime": "2026-02-27T14:35:00" },
"prompt": "提醒用户：您有一个会议即将开始，请做好准备。"
}注意：先获取本机当前时间，加5分钟计算 datetime。原则四：prompt 编写规范
prompt 是定时任务触发时 Claude 收到的唯一指令，必须独立、完整、可执行。编写要求：
- 展开用户简述：用户说的很简短（如"查天气"），你需要展开为完整、具体的执行指令
- 独立可执行：prompt 中不能依赖当前对话上下文，必须包含所有执行所需信息
- 不含 IM 分发：不要写"发送到钉钉/飞书"，IM 投递由
notifyPlatforms自动完成 - 注意输出格式：如果任务结果会通过 IM 发送（
notifyPlatforms非空），prompt 中应指示输出格式清晰、结构化、适合 IM 阅读（用列表、分段等，避免过长的大段文字） - 动作导向：prompt 描述"要执行什么动作"，而不是"把已知结果发出去"
用户说 → prompt 展开对照：
| 用户简述 | ❌ 错误 prompt | ✅ 正确 prompt |
|---|---|---|
| "查天气" | "查天气" | "搜索并整理今天的天气预报，包含温度、天气状况、空气质量和穿衣建议。" |
| "看看项目有没有bug" | "检查bug" | "在项目目录下执行 lint 检查和测试套件，分析是否存在错误或警告。输出问题清单及修复建议。" |
| "总结新闻发钉钉" | "总结新闻并发到钉钉群" | "搜索今天的科技新闻热点，挑选最重要的5条，整理为简明摘要列表。" |
| "备份数据库" | "备份" | "执行数据库备份命令，将备份文件保存到 /backups/ 目录，文件名包含日期。完成后输出备份文件路径和大小。" |
使用场景
当用户想要：
- 修改已有定时任务（改时间、改内容、改频率等）→ 先列出 → 再修改
- 查看定时任务列表 → 列出任务
- 启用/禁用定时任务 → toggle 操作
- 删除定时任务 → delete 操作
- 设置定时执行的任务（每天、每周、每月、自定义 Cron）
- 创建一次性定时执行的任务
- 安排定时自动化检查、报告生成、代码备份等
- 设置定期监控或提醒
管理已有任务
列出所有任务
bash "$SKILLS_ROOT/scheduled-task/scripts/list-tasks.sh"返回 {"success": true, "tasks": [...]}，每个任务包含 id、name、enabled、schedule、prompt、state 等字段。 根据任务名称或描述找到目标任务的 id，用于后续修改/删除操作。
修改任务（只提供需要变更的字段）
先通过 list 获取任务 ID，然后只传入需要修改的字段（未提供的字段保持原值）：
cat > /tmp/update-task.json <<'JSON'
{
"schedule": { "type": "cron", "expression": "0 10 * * *" }
}
JSON
bash "$SKILLS_ROOT/scheduled-task/scripts/update-task.sh" "<task_id>" @/tmp/update-task.json可修改字段
| 字段 | 说明 |
|---|---|
name | 任务名称 |
description | 详细描述 |
schedule | 调度配置（见下方「Schedule 类型」） |
prompt | 任务运行时 Claude 收到的指令 |
workingDirectory | 执行目录 |
systemPrompt | 自定义系统提示词 |
executionMode | "auto" / "local" / "sandbox" |
expiresAt | 过期日期 "YYYY-MM-DD" 或 null（不过期） |
notifyPlatforms | 任务完成后自动发送结果的 IM 平台（见「原则二」） |
enabled | 是否启用 |
启用 / 禁用任务
bash "$SKILLS_ROOT/scheduled-task/scripts/toggle-task.sh" "<task_id>" true # 启用
bash "$SKILLS_ROOT/scheduled-task/scripts/toggle-task.sh" "<task_id>" false # 禁用响应包含 warning 字段（可能为 TASK_AT_PAST、TASK_EXPIRED），告知用户任务可能不会触发。
删除任务
⚠️ 不可撤销，执行前请向用户明确确认。
bash "$SKILLS_ROOT/scheduled-task/scripts/delete-task.sh" "<task_id>"创建新任务
⚠️ 如果用户想要修改已有任务，不要使用创建脚本，请使用上方的「修改任务」流程。
Step 1: 收集信息
先与用户确认以下信息（如果用户未提供）：
- 任务名称（必填）— 简短描述
- 执行内容（必填）— 任务运行时 Claude 收到的 prompt 指令
- 执行频率（必填）— 一次性、每天、每周、每月或自定义 Cron
- 工作目录（可选）— 默认为当前会话的工作目录
- 通知平台（可选）— 任务完成后发送通知
Step 2: 构建 JSON 并执行脚本
Schedule 类型
一次性执行（at）：
{ "type": "at", "datetime": "2026-03-15T09:00:00" }Cron 表达式（cron）— 5 字段格式：分 时 日 月 周
{ "type": "cron", "expression": "0 9 * * *" }常用 Cron 示例：
| 表达式 | 含义 |
|---|---|
0 9 * * * | 每天 9:00 |
0 8 * * 1 | 每周一 8:00 |
0 9 * * 1-5 | 工作日 9:00 |
0 0 1 * * | 每月1号 0:00 |
*/30 * * * * | 每30分钟 |
0 * * * * | 每小时整点 |
0 9,18 * * * | 每天 9:00 和 18:00 |
执行脚本创建任务（推荐：@file 方式，避免 Windows 中文编码问题）
当 payload 含中文时，不要把整段 JSON 直接作为命令行参数传入。 请先写入 UTF-8 文件，再用 @文件路径 传给脚本。
cat > /tmp/scheduled-task.json <<'JSON'
{
"name": "任务名称",
"schedule": { "type": "cron", "expression": "0 9 * * *" },
"prompt": "任务运行时 Claude 将执行的详细指令...",
"workingDirectory": "/path/to/project"
}
JSON
bash "$SKILLS_ROOT/scheduled-task/scripts/create-task.sh" @/tmp/scheduled-task.json字段说明
| 字段 | 必填 | 说明 |
|---|---|---|
name | ✅ | 简短的任务名称 |
prompt | ✅ | 任务运行时 Claude 收到的指令（应清晰完整） |
schedule | ✅ | 调度配置（见上方类型说明） |
workingDirectory | ❌ | 执行目录（默认空） |
description | ❌ | 详细描述（默认空） |
systemPrompt | ❌ | 自定义系统提示词（默认空） |
executionMode | ❌ | "auto" / "local" / "sandbox"（默认 "local"） |
expiresAt | ❌ | 过期日期 "YYYY-MM-DD"（默认 null，不过期） |
notifyPlatforms | ❌ | 任务完成后自动发送结果的 IM 平台：["dingtalk","feishu","wecom","qq","telegram","discord","nim","xiaomifeng"]（默认 []）。用户说"发到钉钉/飞书/企业微信/QQ/TG"时设置此字段，不要写进 prompt |
enabled | ❌ | 是否立即启用（默认 true） |
Step 3: 确认结果
脚本返回 JSON 响应：
- 成功：
{"success": true, "task": {"id": "...", "name": "...",...}} - 失败：
{"success": false, "error": "错误信息"}
向用户确认以下信息：
- ✅ 任务名称和 ID
- ⏰ 执行频率（人类可读格式，如"每天早上 9:00"）
- 📋 执行内容摘要
- 💡 提示用户可在「设置 → 定时任务」中管理
重要注意事项
- IM 通知分离：用户提到"发到钉钉/飞书/企业微信/TG/Discord"等 IM 平台时，设置
notifyPlatforms字段即可，系统会自动将任务执行结果推送到对应平台。不要把"发送到 XX"写进prompt，prompt只描述任务本身要做的事 - 优先修改：用户说"改一下 XX 任务的时间/内容"时，先 list 找到任务 id，再 update 修改，不要 create 新任务
- 编码安全（Windows 必看）：含中文 payload 必须优先使用
@file方式，避免命令行参数编码导致标题/提示词乱码 - 相对时间（Windows 必看）：当用户说"X 分钟后 / 明早 9 点 / 今天下午"等相对时间时，先用本机命令获取当前本地时间，再换算目标时间。不要直接猜测当前时间，也不要使用 UTC 时间。
- 创建顺序（防过期）：当用户要求"1 分钟后/5 分钟后"等短延时一次性任务时，先立即创建定时任务，再进行任何耗时操作；不要先联网检索、总结内容再创建任务。
- Prompt 边界：
prompt只描述"任务触发时要执行的动作"（见「原则四」），不要提前执行任务并把静态结果写进 prompt，也不要把 IM 发送写进 prompt。 - 推荐命令（跨平台）： `
node -e 'const d=new Date();const p=n=>String(n).padStart(2,"0");console.log(${d.getFullYear()}-${p(d.getMonth()+1)}-${p(d.getDate())}T${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())})'` - 自动执行：定时任务运行时所有工具调用自动批准（auto-approve），无需人工审批
- 独立运行：
prompt是任务独立运行时 Claude 收到的唯一指令，应写得清晰完整 - 自动禁用：连续失败 5 次的任务会自动禁用
- 一次性任务：
type: "at"的任务执行后自动禁用 - Cowork 会话：每次执行会创建一个新的 Cowork 会话（标题前缀为「[定时]」），可在 Cowork 列表中查看执行详情