长任务防循环、防过度思考与上下文耗尽的自检与交接方法

当 Claude Code 执行长多步任务时出现重复步骤、反复读同一文件、绕圈犹豫或上下文将满，用逐步自检来打破循环、限制推理并干净交接。

适用场景

解决思路

1. 在每一步之前运行检查清单：检查是否在循环、是否过度思考、上下文是否紧张；若都不触发就继续执行该步骤。
2. 循环检测：若满足以下任一条件即视为循环——重读本会话已读且未变更的文件；用相同参数重跑命令/工具并期待相同结果；回到已尝试并放弃的假设；在没有新证据下“从头重新考虑”；最近 2 步没有获得新信息。注意：重读刚编辑过的文件不算循环，那是验证。
3. 循环触发时停止，并只做以下之一：用一句话陈述阻塞点并向用户提出具体问题；写下已知与未知，然后采取与上次不同的行动；若同一子问题已循环 2 次以上，宣布暂时无解，继续前进或交接。
4. 绝不重复已失败的动作并期待不同结果。
5. 重试上限：同一失败命令绝不运行第 3 次；某个东西（命令、测试运行器、导入）尝试约 3 次（即使变体不同）仍无法工作，就停止并询问用户，不要继续尝试更多变体。
6. 不要盲目编辑——这是最大的循环来源。编辑前先读足够内容以确认改动正确；每次编辑后，在下一步之前验证（读 diff / 运行 / 跑测试）。一次编辑对应一次检查。
7. 限制思考：每步推理上限约 1000 词，超过就是在犹豫而非行动。
8. 决定 → 行动 → 观察；不要重新推导已做出的决定。
9. 若约 1000 词内无法决定，说明任务描述不充分——向用户提出一个尖锐问题。
10. 不要向自己复述整个问题；引用已得出的结论，不要重建它。
11. 上下文预算：权威信号是出现关于低上下文/即将自动压缩的 <system-reminder>，此时立即交接，不要开始新工作。
12. 否则，统计当前为真的信号数量：任务已进行 20+ 个助手回合；已读 5+ 个文件或任一超大文件/日志/转储；有不断回滚查看的长工具输出；还剩 3+ 个计划步骤。
13. 根据为真的信号数量决定：数量为 0 或 1 → 正常继续工作；数量为 2、3 或 4 → 交接，先完成当前步骤，然后进入交接流程。先计数再决定，不要凭感觉判断；数量越高表示上下文压力越大，而非越小；处于最后一步或“快完成了”不会降低计数或取消交接。
14. 在任何昂贵步骤（大读取、新子任务、长生成）之前问自己：“有空间完成这个并在之后交接吗？”若计数表明应交接，完成当前原子单元后交接，不要开始下一步。
15. 干净交接：先落地持久产物——保存文件、提交、写出结果，确保不丢失任何东西。
16. 调用 handoff 技能来压缩对话，不要手写交接内容。
17. 明确告诉用户：“上下文快满了——现在交接；请开启新会话（/clear）。”

适用边界 · 注意事项

• 任务短小、单步即可完成时无需启用此自检流程。
• 重读刚编辑过的文件属于验证而非循环，不应据此触发循环处理。
• 仅当出现低上下文提醒或计数达到 2 以上才交接；计数为 0 或 1 时应正常继续，不要过度交接。