一句话结论: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、保持分支可快进」。

防漂移的五条硬规则

  1. 进度落盘:loop 跨压缩/续会话时,文件比聊天可靠。
  2. 一次一轮只做一个最小步骤:禁止「顺便重构」。
  3. 完成态可机读:测试命令、文件存在、CI 状态,而不是「感觉差不多」。worktree 场景先对齐树,见《issue 做完了吗》。
  4. 环境前置写进 AGENTS.md:依赖/端口/命令绝对路径,减少「写代码前就失败」,见《环境硬约束》。
  5. 人工闸门:涉及发布、删数据、付费 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 为通用模板,可按小说或工程改写。