定时任务

CodeBuddy Code 支持在会话中创建和管理定时任务，可以按照设定的时间表重复执行指令，或者在未来某个时间点触发一次性操作。常见用途包括：定期检查构建状态、轮询任务完成情况、在特定时间点提醒自己等。

注意：

定时任务是会话级别的。任务只在 CodeBuddy Code 运行期间有效，退出后自动清除。

使用 /loop 创建循环任务

/loop 是创建循环任务最便捷的方式。您只需指定时间间隔和要执行的指令，系统会自动转换为 cron 表达式并创建任务。

语法

/loop [时间间隔] <指令>

常用示例

检查 CI/CD 流水线状态：

/loop 3m 检查一下流水线是否跑完，把结果告诉我

定时运行单元测试：

/loop 30m 帮我运行一次单元测试，如果有失败的用例告诉我

每小时汇总代码审查待办：

/loop 1h 看一下有没有新的 PR 需要我审查

配合自定义命令使用：

/loop 10m /check-build

使用自然语言描述频率（结尾加 every）：

帮我监控接口响应时间 every 8m每隔 25m 检查一下部署状态

间隔不指定时的默认行为

如果只写指令而不写时间间隔，默认每 10 分钟触发一次：

/loop 检查一下后端服务是否正常响应

每轮自主调整下一轮间隔

/loop 任务每次触发执行完毕后，AI 会根据本轮结果自主判断下一轮应该：提前触发、延后触发、维持原定间隔，或者直接结束循环。例如"检查一下流水线是否跑完"这类任务，如果流水线还在跑，AI 可能会决定缩短下一轮间隔以更快得到结果；如果流水线已经跑完，AI 可能会决定结束循环。

这个调整是自动进行的，不需要您手动干预；循环最长仍然只会持续 3 天，随时可以按取消任务一节手动结束。

创建一次性提醒

如果只需要在未来某个时间点提醒一次，可以直接用自然语言描述：

下午四点半提醒我同步一下今天的进展一个小时后看看刚才那个构建任务有没有产出明天早上 9 点帮我生成一份昨天的工作日报

这类任务会在指定时间触发一次，执行完毕后自动删除。

管理已有任务

查看当前所有任务

我现在有哪些定时任务？

列表中包含任务 ID、执行频率、任务类型（循环 / 一次性）以及对应的指令。

取消任务

取消部署检查的定时任务

或者通过任务 ID 取消：

帮我删掉 ID 为 xxx 的定时任务

底层分别对应 CronList 和 CronDelete 工具，可以通过对话直接操作，无需记住具体命令。

任务执行机制

执行时机

任务只会在会话空闲时触发，即系统没有在处理其他请求的时候。如果正好在执行某个操作，触发时间会顺延到操作完成后。

时间偏移（Jitter）

系统会对任务的触发时间添加少量随机偏移，以避免大量任务同时执行带来的拥堵：

循环任务：最多延迟周期时长的 10%（上限 15 分钟）

一次性任务：对于整点和半点任务，最多提前 90 秒执行

例如，设置 每小时 执行的任务，实际触发时间可能在整点后的 0-6 分钟内随机分布。

自动过期

循环任务在创建 3 天后自动过期删除，过期前会最后触发一次。  

如果需要任务持续更长时间，可以在过期后重新创建，或者改用外部调度方案（如 GitHub Actions 等）。

Cron 表达式参考

需要“每周一早上 10 点”“每月 1 号”这类精确时间，直接告诉 AI 您的需求，它会自动转成 cron 表达式并创建任务：

每周一早上 10 点帮我生成本周的工作计划每月 1 号早上统计上个月的代码提交量，按人汇总每周五下午 5:30 提醒我同步进度、更新任务状态每天中午 12 点检查一下有没有待我审查的 PR工作日早上 9:15 把昨天未合并的 PR 列出来

AI 回复时会告诉您实际使用的 cron 表达式和执行频率，方便确认是否符合预期。

格式：

分钟  小时  日期  月份  周几

常用表达式：

字段说明：

注意事项

禁用定时任务

如果需要完全关闭定时任务功能，可以设置环境变量：

CODEBUDDY_DISABLE_CRON=1 codebuddy

启用后，/loop 技能不再可用，CronCreate、CronList、CronDelete 工具也会被禁用。

相关文档

技能系统

斜杠命令参考

会话与上下文管理

Hooks 事件系统