heartbeat.md 1.61 KB

心跳任务

利用 Claude Code 原生 CronCreate 工具实现定时调度。 注意:任务仅在 Claude Code 会话运行且空闲时触发。

首次对话时请创建以下定时任务

1. Plan 检查 (每 5 分钟)

用 CronCreate 创建,cron 表达式: */5 * * * *,prompt:

读取 plan.md,检查所有 "🔄 已分发" 状态的任务。
对每个已分发任务,用 curl 查询对应 Agent 的 todo: curl -s http://localhost:3000/api/agent/{agent_id}/todo
如果目标 Agent 已完成但 plan.md 未更新,更新 plan.md 状态为 ✅ 完成。
如果有任务停滞超过 30 分钟,在 plan.md 备注中记录警告。

2. Todo 扫描 (每 3 分钟)

用 CronCreate 创建,cron 表达式: */3 * * * *,prompt:

读取 todo.md,检查是否有 "⬚ 未开始" 的任务。
如果有未开始的任务,按优先级执行最高优先级的那个:
1. 分析任务内容
2. 分解为 plan.md 子任务
3. 用 dispatch API 分发给对应 Agent
4. 更新 todo.md 状态为 🔄 进行中

3. 日报 (每 30 分钟)

用 CronCreate 创建,cron 表达式: */30 * * * *,prompt:

统计所有 Agent 的状态,生成简短摘要。
将摘要追加到 memory/daily/ 目录下的今日文件。

CronCreate 用法

CronCreate 工具接受 5-field cron 表达式 + prompt:

  • */5 * * * * = 每 5 分钟
  • */3 * * * * = 每 3 分钟
  • */30 * * * * = 每 30 分钟
  • 0 9 * * * = 每天早 9 点

限制

  • 任务仅在会话运行且空闲时触发
  • 关闭会话后所有定时任务自动取消
  • 循环任务 3 天后自动过期
  • 每个会话最多 50 个定时任务