Harness Producer-Reviewer模式质量审查如何避免无限循环【免费下载链接】harnessA meta-skill that designs domain-specific agent teams, defines specialized agents, and generates the skills they use.项目地址: https://gitcode.com/GitHub_Trending/harness/harnessHarness 是一个面向 Claude Code 的团队架构工厂——用一句话描述你的领域它就能自动生成一支由专职 AI Agent 组成的团队以及它们各自的技能。在 Harness 提供的 6 种团队架构模式中Producer-Reviewer 模式生成-验证模式是保证产出质量最常用的方案先由生成者产出再由审查者质检不合格就重新生成。但不少用户在实际落地时都踩过同一个坑——审查者总挑出毛病、生成者反复重做结果陷入审查→重审的无限循环白白烧掉时间和 Token。这篇文章带你用 3 个关键设计最大重试次数、三级判定、升级路径彻底避免这个陷阱。什么是 Producer-Reviewer 模式先生成后审查Producer-Reviewer 模式让**生成 AgentProducer与审查 AgentReviewer**成对协作工作流是一个带回路的闭环[生成 Agent] → [审查 Agent] → 发现问题→ [生成 Agent 重新执行]它的核心思想借鉴了人类团队的写稿人 编辑分工写的人不负责挑错挑错的人不负责重写。两个角色各司其职互相制衡产出质量自然更高。这个模式最适合两类场景✅产出质量要求高内容要对外发布、代码要合并上线✅存在客观验证标准比如风格一致性、可读性、数据准确性而不是纯主观偏好模式的完整定义可以查阅官方参考文档agent-design-patterns.md。为什么质量审查容易陷入无限循环听起来很美的生成→审查→再生成闭环一旦缺少约束条件就会变成成本黑洞。常见的三个失控原因失控原因具体表现 没有终止条件审查者总能找到还能更好的点循环永不停止️ 审查标准主观感觉不太对式的反馈生成者无法针对性修复 反馈不具体只说重写却不指明哪里、为什么重做结果依旧不合格Harness 的官方文档对此有明确警告무한 루프 방지를 위해 최대 재시도 횟수(2~3회) 설정 필수——为防止无限循环必须设置最大重试次数2~3 次见 agent-design-patterns.md。下面三个设计点就是 Harness 给出的完整答案。避免无限循环的 3 个关键设计关键一设置最大重试次数2~3 次这是防循环的第一道硬闸门。在审查者的定义文件中明确写死循环上限例如再生成后重新审查最多 2 次循环。到达上限后不再无限重试而是进入升级路径见关键三。 经验值2~3 次足够覆盖绝大多数可以修好的问题超过 3 次仍在循环通常说明问题不在产出本身而在需求描述或上游输入。关键二用客观标准的三级判定PASS / FIX / REDO循环失控往往源于审查结论模糊。Harness 的示例审查者webtoon-reviewer要求每次审查必须输出明确的三级判定✅PASS合格直接通过FIX局部小修即可附具体修改方向REDO需要整体重新生成附具体重做要求同时强调审查者必须基于客观标准一致性、可读性、构图等判断而不是主观口味。判定越具体生成者的返工就越有的放矢一轮就能修对——减少修了个寂寞式的空转循环。关键三为重试用尽设计升级路径到达重试上限后流程不能简单卡死而是向上升级。Harness 的实战方案分三层强制 PASS 警告2 次重做后仍不合格的面板带上警告标记放行不阻塞整体进度根因升级如果超过 50% 的产出被判 REDO说明不是手滑而是提示词/需求本身有问题——此时向用户提出修改建议改源头而不是死磕循环缺失显式化单点失败重试 1 次仍不行就在最终报告中标注该部分未收集继续推进整体流程见 orchestrator-template.md这三层设计保证了任何情况下流程都能收敛出结果。实战案例Webtoon 制作团队的最多 2 次循环Harness 文档中有一个非常完整的 Producer-Reviewer 落地案例——Webtoon 漫画制作团队由webtoon-artist画师和webtoon-reviewer质检两个 Agent 组成Phase 1画师 Agent 生成面板图像Phase 2质检 Agent 逐面板输出 PASS/FIX/REDO 判定报告Phase 3对 REDO 面板定向重新生成携带具体修改指令最多 2 次其重试策略原文为REDO 判定面板 → 向画师发起重生成请求含具体修改指令 最多 2 次循环后强制 PASS 超过 50% 面板为 REDO → 向用户提出提示词修改建议这个案例完整演示了硬上限 具体反馈 根因升级三件套如何协同完整定义见 team-examples.md。循环终止条件同样适用于技能测试与团队进化有限循环的思想在 Harness 中是全局性的。在技能测试阶段官方定义了明确的迭代改进循环终止条件见 skill-testing-guide.md用户表示满意反馈全部为空所有产出无问题已无有意义的改进空间此外Harness 的 QA 指南还建议在每个模块完成后立即执行 QA增量式审查而不是等全部做完再一次性审查——早期发现边界问题能避免错误累积后引发更大范围的返工循环。完整方法见 qa-agent-guide.md。快速上手5 分钟搭一支质量审查团队想在自己的项目中用上 Producer-Reviewer 模式流程非常简单按 docs/quickstart.md 安装 Harness 插件并启用 Agent Teams对 Claude Code 说一句话触发Build a harness for this projectHarness 会自动分析你的领域生成.claude/agents/下的 Agent 定义与.claude/skills/下的技能文件如果你的领域涉及内容创作、文档生成、代码产出等质量敏感任务可以直接在触发语中说明生成后需要质量审查Harness 会优先为你设计 Producer-Reviewer 架构。整个 6 阶段工作流详解见主技能文件 SKILL.md。总结让质量审查审得动也停得下Producer-Reviewer 模式的价值不在于审查本身而在于有节制、可收敛的审查。回顾本文的三个关键设计硬上限最大重试 2~3 次从机制上杜绝无限循环三级判定PASS / FIX / REDO 客观标准让反馈可执行升级路径重试用尽就放行警告、改提示词根因、缺失显式标注流程永远能收敛记住这个心法审查者可以挑剔但流程必须有出口。这既是对产出质量的保证也是对时间与 Token 成本的尊重。【免费下载链接】harnessA meta-skill that designs domain-specific agent teams, defines specialized agents, and generates the skills they use.项目地址: https://gitcode.com/GitHub_Trending/harness/harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考