Triad Workflow：三角色状态机驱动的多Agent异步协作开发框架

Triad Workflow 是一个沉淀自AIGC Gateway项目实践的工程化框架，通过Planner、Generator、Evaluator三角色分离和7状态机驱动，实现Claude CLI与Codex的多Agent异步协作开发。

Triad Workflow（早期曾命名为"Cowork + Harness"）并非纸上谈兵的理论框架，而是源于AIGC Gateway项目完整实施过程的实战总结。它的诞生源于一个核心观察：当多个AI Agent（如Claude CLI和Codex）协同工作时，最大的挑战不是单个Agent的能力，而是角色边界模糊、状态管理混乱、跨会话记忆丢失。

传统的多Agent协作往往依赖于Agent之间的直接通信，这在实际工程中存在诸多问题：网络不稳定、工具差异、上下文窗口限制。Triad Workflow提出了一种全新的解决方案：Git作为协作总线。

Triad Workflow的核心设计是三角色严格分离，没有任何Agent评估自己的工作：

Planner是"做什么"的决策者。它负责：

• 理解用户需求，将其转化为可执行的功能规格
• 制定开发计划，确定批次范围和优先级
• 编写规格文档（硬性要求），生成features.json
• 与用户确认功能范围，管理用户期望

Planner不直接编写代码，它的产出是清晰的规格和计划。

Generator是"怎么做"的执行者。它负责：

• 根据Planner的规格文档实现具体功能
• 编写代码、配置、测试用例
• 每完成一个功能更新progress.json并推送
• 检查CI状态，红色即停止新功能开发

Generator不评估自己的工作质量，它的产出是功能实现和代码提交。

Evaluator是"做得对不对"的把关者。它负责：

• 设计并编写测试（测试域所有权归Evaluator）
• 执行executor:codex功能，产出测试报告
• 出具PASS、PARTIAL或FAIL的验收结论
• 编写evaluator_feedback指导修复

Evaluator不直接修改代码，它的产出是验收结论和反馈。

Triad Workflow使用严格的状态机管理开发流程，状态转换由progress.json中的status字段驱动：

new → planning → building → verifying → fixing ⟷ reverifying → done

• new：新需求批次开始，等待Planner介入
• planning：Planner正在分析需求、编写规格
• building：Generator正在实现功能
• verifying：Evaluator正在验收
• fixing：根据Evaluator反馈修复问题
• reverifying：修复后重新验收（可循环）
• done：批次完成，进入学习沉淀阶段