| name | code-review-loop |
| description | 每 5 分钟自动审查一次当前未提交的代码变更（git diff），在当前会话期间循环执行。
会话结束或 Claude 进程被终止时循环自动失效（session-only，不写入磁盘、不跨会话残留）。
当用户说“定时审查代码 / 每5分钟审查一次 / 开始审查循环 / 停止审查循环”时激活。
|
| version | 1.0.0 |
| author | Hermes |
| allowed-tools | ["Bash","CronCreate","CronList","CronDelete"] |
| metadata | {"hermes":{"tags":["code-review","loop","cron","watch","automation","session-only"]}} |
🔁 Code Review Loop — 定时代码审查循环
每 5 分钟审查一次当前的代码变更（git diff），在当前会话期间持续循环。
不持久化：会话结束或进程被杀，循环自动失效，不会跨会话残留。
触发时机
- 用户说“定时审查代码 / 每 5 分钟审查一次 / 开始审查循环” → 启动
- 用户说“停止审查 / 停止循环 / 结束审查” → 停止
执行流程
1. 启动循环
调用 CronCreate 创建一个 session-only 定时任务：
| 参数 | 值 | 说明 |
|---|
cron | */5 * * * * | 每 5 分钟触发一次 |
prompt | 见下方「每轮审查 prompt」 | 每次触发时注入对话的指令 |
recurring | true | 周期性任务 |
durable | false | 关键：不写入 scheduled_tasks.json，进程结束即失效 |
创建后，向用户回报：
- ✅ 循环已启动 + 返回的 job ID
- 停止方式：关闭会话/杀进程即自动停止，或说“停止审查循环”主动停止
2. 每轮审查 prompt
将以下文本原样作为 CronCreate 的 prompt 参数（cron 每次触发时注入对话）：
[定时代码审查] 审查当前未提交的代码变更：
1. 先运行 `git status --short` 和 `git diff --stat` 判断是否有变更
2. 无变更 → 只回复“✅ 暂无新变更”，立即结束本轮（不空跑、不编造问题）
3. 有变更 → 运行 `git diff` 取出变更，审查 bug / 安全 / 逻辑错误，按 严重 / 中等 / 轻微 分级，每条格式：`文件:行 — 问题 — 建议`
4. 只审查、不修改代码
3. 停止循环
两种方式（都满足“用户终止即失效”）：
- 被动：关闭会话 / 杀掉 Claude Code 进程 → session-only 任务随之消失（因为
durable: false）
- 主动：调用
CronList 找到本循环的 job ID → CronDelete 删除
核心规则
- 只读：审查循环绝不修改代码，只报告问题
- 不空跑：无 diff 时必须立即结束本轮，避免浪费 token
durable 必须为 false：否则会落盘并跨会话残留，违反“终止即失效”要求- 7 天上限：Claude Code 的周期任务最多跑 7 天会自动过期（硬限制），需要长期运行时重新启动
注意事项
- 审查范围默认是未提交的变更（
git status + git diff，含已暂存和未暂存，不含已 commit 的）
- 触发受 REPL 空闲约束：你正在对话时不会打断，当前一轮结束后才 fire
- 调整间隔改
cron 字段即可（如 */10 * * * * 为 10 分钟，0 * * * * 为每小时）
