一句话结论:Claude Code 的
/loop适合把「同一套标准」重复执行到外部条件满足为止——审一章、改一章、推下一章,或盯 CI / 评论直到能合并。它不是无人自动驾驶: 会话要开着、要有可验证的停止条件,模糊产品决策不要丢给 loop。
/loop 是什么
/loop 是会话内定时重跑提示词的技能:在当前 Claude Code 会话保持运行时,按间隔再次执行同一段 prompt 或另一个 slash skill。
| 你输入 | 行为 |
|---|---|
/loop 5m <prompt> | 固定间隔 |
/loop <prompt> | 每轮由 Claude 在 1 分钟~1 小时间选等待 |
/loop | 跑内置维护 prompt,或你的 loop.md |
要点(官方文档):
- 机器要开、会话要在;关掉就停
- 周期性任务大约 7 天过期
- 可
/loop 20m /review-pr 1234这种「间隔 + skill」 - 需要跨会话持久调度时,用 Desktop / Cloud scheduled task,而不是裸
/loop
这和 Codex 里把「审→改→写新章」锁成不停目标是同一类问题,只是调度器不同。Codex 侧写法见《Codex 不停循环写长篇》。
什么时候该用
适合
- 小说 / 长文:按章审核 → 修改 → 推进下一章,标准不变
- 工程:Issue 落地后等 CI、处理 review、rebase,直到可合并
- 外部系统轮询:部署是否完成、队列是否清空
不适合
- 还没定题材 / 玩法 / API 形状的产品讨论
- 每次迭代验收标准都在变
- 需要频繁人工审美拍板的镜头/文案(短剧分镜可以半自动,但「好不好看」别全交给 loop)
通用循环模板(复制后改占位符)
先在仓库放一个进度文件,避免只靠对话记忆:
docs/agent-loop-progress.md:
# Loop progress
- goal: <一句话目标>
- done_when: <可客观检查的条件,如 "CI green + 无 open review threads" 或 "chapters 1-10 reviewed">
- branch: <feature-branch>
- last_ok: <ISO时间或空>
- blockers: <无 / 列表>
然后:
/loop 15m
你在执行一个自调度循环。每次被唤醒时严格按顺序做,不要闲聊:
1. 读 docs/agent-loop-progress.md 与相关源文件/章节。
2. 对照 done_when:若已满足,输出 DONE,列出证据,并停止继续调度(取消 loop)。
3. 若未满足:只做「当前最小下一步」(一次审核或一次修复或一次推进),改动保持最小。
4. 跑验证:<YOUR_TEST_CMD> ;失败则修到通过或写入 blockers 后结束本轮。
5. 更新 progress:last_ok、blockers、下一步预告。
6. 禁止:无关重构、扩 scope、改密钥、强推 main、跳过验证。
工作树规则:先确认当前 git worktree / 分支与 progress 一致,再声称「做完了」。
小说连载可以把第 3 步写成:
3. 审核当前章(文风/连续性/禁改人设);按意见修改;仅当审核通过才创建下一章草稿。
验证:对照人设卡与大纲文件,输出通过/不通过清单。
工程合并可以把 prompt 换成 skill:/loop 10m /babysit-pr <号>(若你有自建 skill),或直接写「查 CI、回 review、保持分支可快进」。
防漂移的五条硬规则
- 进度落盘:loop 跨压缩/续会话时,文件比聊天可靠。
- 一次一轮只做一个最小步骤:禁止「顺便重构」。
- 完成态可机读:测试命令、文件存在、CI 状态,而不是「感觉差不多」。worktree 场景先对齐树,见《issue 做完了吗》。
- 环境前置写进 AGENTS.md:依赖/端口/命令绝对路径,减少「写代码前就失败」,见《环境硬约束》。
- 人工闸门:涉及发布、删数据、付费 API 批量调用,必须停下来问人。
常见翻车
| 现象 | 原因 | 处理 |
|---|---|---|
| loop 不触发 | 会话关了 / 机器睡了 | 改用 Desktop/Cloud 调度,或保持会话 |
| 越跑越歪 | 缺少 done_when / 进度文件 | 补模板第 1、2 步 |
| 上下文反复续写 | 单会话塞太久 | 章/Issue 级切会话;摘要进 progress |
| 声称完成但在错 worktree | 多 worktree 并行 | 每轮先 git rev-parse --show-toplevel 与分支名 |
| 7 天后突然停 | 官方过期 | 到期前重建,或换持久调度 |
写在最后
/loop 的价值不是「更勤快」,而是把验收标准固定下来,让时间成为重复执行器。标准写不清,loop 只会稳定地重复犯错。
口径:/loop 行为以 Claude Code scheduled tasks 文档 为准(2026-11-06);进度文件与 prompt 为通用模板,可按小说或工程改写。
COMMENTS
读者评论