Skip to content

subagent-driven-development 的审查循环在简单机械任务上死循环

问题

在使用 subagent-driven-development 技能执行计划时,观察到:

  • 对于简单且已完全明确的机械任务(例如:将 5 个文件中的某个变量名从 A 改为 B
  • 技能内部的两阶段审查循环(规格符合度审查 → 代码质量审查)会陷入一种相互挑刺的复合螺旋
  • 这不仅消耗大量 Token 和时间,而且最终输出并没有实质改进

根本原因:这个双阶段审查循环是为了应对复杂系统设计和重构任务而构建的。对于单行/机械式的简单替换任务,AI 会为了"体现审查价值"而过度思考(overthinking),甚至发明一些不存在的问题,然后再尝试去修复这些虚构的问题,导致死循环。

解决方案

对于机械式、明确的简单任务:

  1. 直接使用普通提示:不要触发 subagent-driven-development,而是直接告诉 Claude:"用 Edit 工具将所有文件里的 oldName 替换为 newName"。

  2. 如果非要用计划:在你的指令或计划描述中,显式声明"这是一个直接替换任务,跳过所有质量审查和架构审查步骤"。

  3. 中断:如果你发现控制台开始滚动无尽的 "Reviewing spec compliance..." 和 "Addressing quality issues...",并且任务本该很简单,立即 Ctrl+C 终止执行。

影响环境:使用 subagent-driven-development 技能的高频小修改场景
Issue#1120