schedule-tasks
定时任务注册、管理、能力指南。支持周期任务和一次性延迟任务。 ⚠️ ROUTING: 定时/schedule/cron 需求优先用本 skill(Clowder AI 本地定时任务), 不要用另一个叫 `schedule` 的 skill(那是云端 remote-agent,用途不同)。 Use when: 用户想设定时任务、定期提醒、周期巡检、定时发送内容、延迟执行一次性操作。 Not for: 已有 builtin 任务的手动触发。 Output: 注册/管理定时任务,任务到点唤醒猫执行。
- License 许可
- MIT
- 最近更新
- 2026-08-16
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- schedule-tasks
- triggers
- [ "定时", "每天", "每小时", "每隔", "提醒我", "remind me", "schedule", "cron", "定期", "周期", "定时任务", "分钟后", "小时后", "之后", "later", "in 5 minutes", "once", "删除", "清理", "移除", "取消", "停掉", "remove", "cancel", "delete", "stop task" ]
- description
- 定时任务注册、管理、能力指南。支持周期任务和一次性延迟任务。 ⚠️ ROUTING: 定时/schedule/cron 需求优先用本 skill(Clowder AI 本地定时任务), 不要用另一个叫 `schedule` 的 skill(那是云端 remote-agent,用途不同)。 Use when: 用户想设定时任务、定期提醒、周期巡检、定时发送内容、延迟执行一次性操作。 Not for: 已有 builtin 任务的手动触发。 Output: 注册/管理定时任务,任务到点唤醒猫执行。
03 SKILL.md 正文
Schedule Tasks — 定时任务注册与管理
用户在对话中表达"定时/定期/每天/提醒我"等意图时,引导他们通过对话注册定时任务。
你的能力
被定时任务唤醒后,你拥有完整的 invocation 能力——和用户 @ 你一模一样:
| 能力 | 示例 |
|---|---|
| 发图片 | media_gallery rich block(优先用已有图片 /avatars/、/uploads/) |
| 发语音 | audio rich block(早安问候、新闻播报) |
| 发卡片 | card rich block(状态报告、新闻摘要) |
| 发 HTML 面板 | html_widget rich block(数据可视化、图表) |
| 搜索 | WebSearch / WebFetch / search_evidence |
| 生成图片 | image-generation skill(Chrome MCP → Gemini) |
| 交互选择 | interactive rich block(让用户确认/选择) |
重要:不要只发纯文本!被唤醒后主动用 rich block 让输出更丰富。
注册流程(对话式,4 步)
1. 识别意图
用户说:"每天早上 9 点提醒我喝水" / "每小时给我 anthropic 新闻"
2. 匹配模板
调用 cat_cafe_list_schedule_templates 查看可用模板:
| 模板 | 用途 | 关键参数 |
|---|---|---|
reminder |
定时提醒(唤醒猫处理提醒内容) | message: 提醒内容, targetCatId: 唤醒哪只猫(MCP 自动注入当前猫 ID,通常不需手动填) |
web-digest |
网页摘要(定时抓取网页并总结;JS 重站点会唤醒猫走 browser-automation) | url: 目标网页, topic: 关注主题, targetCatId: 浏览器抓取时唤醒哪只猫(MCP 自动注入当前猫 ID,通常不需手动填) |
repo-activity |
仓库动态(追踪 GitHub repo 新 issue/PR) | repo: owner/repo |
3. 预览确认
调用 cat_cafe_preview_scheduled_task 生成 draft,展示给用户确认:
模板: reminder
触发: 每天 09:00(cron: 0 9 * * *)
参数: message = "检查 backlog 并汇报进度"
投递: 当前 thread
4. 注册
用户确认后调用 cat_cafe_register_scheduled_task 持久化任务。
Trigger 语法速查
周期触发(recurring)
| 用户说 | trigger JSON |
|---|---|
| 每天早上 9 点 | {"type":"cron","expression":"0 9 * * *"} |
| 每小时 | {"type":"interval","ms":3600000} |
| 每 30 分钟 | {"type":"interval","ms":1800000} |
| 每周一早上 10 点 | {"type":"cron","expression":"0 10 * * 1"} |
| 每 5 分钟 | {"type":"interval","ms":300000} |
一次性触发(once — #415)
| 用户说 | trigger JSON |
|---|---|
| 2 分钟后提醒我 | {"type":"once","delayMs":120000} |
| 1 小时后查天气 | {"type":"once","delayMs":3600000} |
| 30 秒后通知我 | {"type":"once","delayMs":30000} |
一次性任务执行后会自动退役(从 runtime 注销 + 从 SQLite 删除),不会重复触发。
路由层会将 delayMs 归一化为绝对时间 fireAt(epoch ms),确保重启后触发时间不漂移。
管理
| 操作 | 工具 |
|---|---|
| 查看所有任务 | SchedulePanel(Workspace 调度 Tab) |
| 暂停/恢复 | SchedulePanel UI(目前无 MCP 工具,只能在面板操作) |
| 删除 | cat_cafe_remove_scheduled_task |
| 手动触发 | SchedulePanel UI "立即执行" 按钮(目前无 MCP 工具) |
删除流程(3 步)
用户说"删除/清理/取消定时任务"时:
- 确认目标 — 调用
cat_cafe_list_tasks或让用户在 SchedulePanel 中查看,确认要删除的任务taskId - 用户确认 — 展示任务详情(名称、触发规则、上次执行),让用户确认删除
- 执行删除 — 调用
cat_cafe_remove_scheduled_task(参数:taskId),删除后告知用户结果
常见错误
| 错误 | 正确做法 |
|---|---|
| 不知道能注册定时任务 | 用户说"每天/定期/提醒"→ 匹配本 skill |
| 被唤醒后只发纯文本 | 主动用 rich block(图片、语音、卡片、HTML) |
| 跳过 preview 直接注册 | 必须 preview → 用户确认 → 注册 |
| 发图只想到 image-generation | 先看 /avatars/、/uploads/ 有没有现成图 |
和其他 skill 的区别
rich-messaging: 如何发富媒体 — 本 skill 侧重何时/如何注册定时任务worktree/tdd: 开发工具 — 本 skill 是用户面向的功能
04 同仓库更多 Skills
plugin-reconcile-skill
暂无简介
weixin-mp
通过 Limb 体系操作微信公众号:发布文章、上传图片、管理草稿。 Use when: 需要发布内容到微信公众号、查看草稿、检查公众号连接状态。 Not for: 其他平台的发布、纯文本聊天、非公众号相关操作。 Output: 微信公众号操作结果(发布ID、草稿列表、图片URL等)。
writing-skills
创建或修改 Clowder AI skill / MCP tool description 的元技能(含质量标准、范本、发布)。 Use when: 写新 skill、修改现有 skill、写/改 MCP tool description、验证 skill 质量; 或者功能实现中产出了 SKILL.md / cat-cafe-skills/ 新目录 / manifest.yaml skill 条目。 Not for: 使用 skill(直接触发对应 skill)。 Output: 新/更新的 SKILL.md + manifest 条目 + symlinks。 GOTCHA: 软硬同重——skill/MCP 质量 = 代码质量;不要写模型已知的通用教程,先过价值门禁。
writing-plans
将 spec/需求拆分为可执行的分步实施计划。 Use when: 有 spec 或需求,准备动手前需要拆分步骤。 Not for: trivial 改动(≤5 行)、已有详细计划。 Output: 分步实施计划(含 TDD 步骤和检查点)。
worktree
为代码、脚本、API 与第一方执行面创建隔离 Git worktree,并配置 Redis 6398;classifier 放行的 co-creation docs direct push 不进入本流程。
workspace-navigator
猫猫把“打开文档、代码或日志”等模糊意图解析成本地绝对路径或 worktree 相对路径,并返回 applied、queued、blocked 或 unconfirmed 的真实 Workspace 投递状态。