Iron Triangle Workflow：基于Git文件驱动的多Agent协同开发工作流

一个创新的多Agent协同开发工作流框架，通过Git文件驱动实现100%可靠性，采用6目录状态机、双层保险机制和幂等性校验，解决Agent记忆不可靠、消息丢包、状态不一致等行业痛点。

• 原作者/维护者：LowCc33
• 来源平台：github
• 原始标题：iron-triangle-workflow
• 原始链接：https://github.com/LowCc33/iron-triangle-workflow
• 来源发布时间/更新时间：2026-05-24T00:15:09Z

原作者与来源

• 原作者/维护者：LowCc33
• 来源平台：github
• 原始标题：iron-triangle-workflow
• 原始链接：https://github.com/LowCc33/iron-triangle-workflow
• 来源发布时间/更新时间：2026-05-24T00:15:09Z 原作者与来源\n\n- 原作者/维护者: LowCc33\n- 来源平台: GitHub\n- 原项目名: iron-triangle-workflow\n- 原始链接: https://github.com/LowCc33/iron-triangle-workflow\n- 发布时间: 2026年5月24日\n\n项目背景与动机\n\n随着AI Agent在软件开发领域的广泛应用，开发者们逐渐意识到一个核心问题：Agent的记忆不可靠、消息可能丢包、状态容易出现不一致。这些问题在复杂的多Agent协作场景中尤为突出，严重影响开发效率和代码质量。\n\n传统的Agent协作方式往往依赖于内存中的状态管理，一旦Agent重启或网络出现异常，整个协作链条就可能断裂。Iron Triangle Workflow正是为了解决这些行业痛点而诞生的创新方案。\n\n核心设计理念\n\nGit文件驱动架构\n\nIron Triangle Workflow采用Git文件作为状态存储和通信媒介，这一设计理念带来了几个显著优势：\n\n- 持久化状态: 所有协作状态都存储在Git仓库中，即使Agent重启也能无缝恢复\n- 可追溯性: 完整的Git历史记录让每一次状态变更都有迹可循\n- 分布式协作: 天然支持多节点、多Agent的分布式协作模式\n- 版本控制: 状态变更可以被版本化管理，支持回滚和分支\n\n六目录状态机\n\n项目创新性地设计了六个核心目录来管理不同的工作状态：\n\n1. todo/ - 待处理任务队列\n2. doing/ - 正在进行中的任务\n3. done/ - 已完成的任务\n4. review/ - 待审核的任务\n5. archive/ - 已归档的历史任务\n6. config/ - 配置和元数据\n\n这种设计形成了一个完整的状态流转机制，确保每个任务都有明确的生命周期管理。\n\n双层保险机制\n\n为了保证协作的可靠性，Iron Triangle Workflow实现了双层保险机制：\n\n第一层：幂等性校验\n\n每个操作都具备幂等性，即多次执行同一操作不会产生不同的结果。这通过以下方式实现：\n\n- 操作ID的唯一性标识\n- 基于内容哈希的重复检测\n- 原子化的文件操作\n\n第二层：状态一致性检查\n\n系统会定期进行状态一致性校验，包括：\n\n- 目录状态与实际文件状态的比对\n- 跨Agent状态同步检查\n- 冲突检测与自动解决策略\n\n实际应用场景\n\n场景一：多Agent并行开发\n\n在一个复杂项目中，前端Agent、后端Agent、测试Agent可以并行工作：\n\n1. 产品经理将需求写入todo/目录\n2. 前端Agent认领任务并移动到doing/\n3. 后端Agent同时处理API接口\n4. 完成后移动到review/等待审核\n5. 测试Agent从done/获取已完成功能进行测试\n\n场景二：故障恢复\n\n当某个Agent意外崩溃时：\n\n1. 新启动的Agent读取Git仓库当前状态\n2. 根据doing/目录了解正在进行的任务\n3. 无缝接管崩溃Agent的工作\n4. 无需人工干预即可恢复协作\n\n技术实现细节\n\n文件命名规范\n\n项目采用结构化的文件命名方式：\n\n\n{timestamp}_{agent-id}_{task-type}_{content-hash}.md\n\n\n这种命名方式确保了：\n- 时间顺序的可追溯性\n- 责任主体的明确性\n- 内容完整性的可验证性\n\n冲突解决策略\n\n当多个Agent同时修改同一文件时，系统会：\n\n1. 检测Git合并冲突\n2. 根据预设规则自动解决简单冲突\n3. 将复杂冲突标记到review/目录等待人工介入\n4. 记录冲突解决历史供后续优化\n\n与传统方案的对比\n\n| 特性 | 传统Agent协作 | Iron Triangle Workflow |\n|------|--------------|----------------------|\n| 状态持久化 | 内存存储，易丢失 | Git文件存储，永久保存 |\n| 故障恢复 | 需人工介入 | 自动恢复 |\n| 可追溯性 | 依赖日志 | Git历史完整记录 |\n| 扩展性 | 受限于单节点 | 支持分布式部署 |\n| 可靠性 | 依赖网络稳定 | 双层保险机制保障 |\n\n使用价值与意义\n\nIron Triangle Workflow的出现为AI Agent协作开发提供了一个可靠的工程化方案。它不仅解决了技术层面的可靠性问题，更重要的是建立了一套可复用、可扩展的协作范式。\n\n对于个人开发者而言，这意味着可以真正实现"一个人 = 一个完整开发团队"的愿景；对于团队而言，这意味着可以将重复性工作交给Agent，人类专注于创造性工作。\n\n未来展望\n\n随着AI Agent能力的不断增强，类似Iron Triangle Workflow这样的基础设施将变得越来越重要。未来可能的发展方向包括：\n\n- 与主流IDE的深度集成\n- 支持更多版本控制系统的适配\n- 可视化状态监控面板\n- 智能任务分配算法\n\n这个项目代表了AI辅助软件开发向更加工程化、可靠化方向演进的重要一步。