Agent Garden：基于Claude Code的多代理开发工作流框架

Agent Garden是基于Claude Code构建的多代理开发工作流框架，通过文件后缀状态机驱动代理协作，实现从需求分析到验收的全流程自动化，为工程化AI辅助开发提供可复现的工作流模式。其核心机制是文件后缀状态机，协调需求分析、架构设计、代码实现等专业化代理分工，推进开发流程。

AI辅助开发工具正从"代码补全"向"全流程自动化"演进。当前需要工程化的多代理协作模式来实现完整开发周期的自动化，Agent Garden项目因此提出，旨在解决这一需求，提供结构化的多代理开发工作流。

文件后缀状态机：文件后缀承载工作流状态，对应不同代理角色与任务，如.req.md（需求分析）、.design.md（架构设计）、.impl.py（代码实现）等。 多代理协作架构：包含需求分析代理（解析需求为结构化规格）、架构设计代理（输出系统架构蓝图）、代码实现代理（利用Claude Code生成代码）、测试编写代理（生成并运行测试）、审查验收代理（质量把关）。

工作流通过文件后缀变化推进：初始需求文档→设计文档→实现代码→测试代码→审查文档→标记完成。该机制具有四大优势：

1. 可观察性：状态体现在文件系统，无需额外数据库；
2. 可恢复性：失败可从当前状态重启；
3. 可审计性：变更历史通过版本控制记录；
4. 可扩展性：新增代理只需定义新状态后缀与规则。

框架基于Claude Code构建，集成点包括：

• 代码生成：利用Claude的代码编写能力实现功能；
• 代码理解：通过Claude分析代码进行审查重构；
• 自然语言处理：解析需求、生成文档；
• 工具调用：与文件系统、测试运行器、Git等集成。

框架在工程化方面的考量：

• 确定性与创造性平衡：状态机提供确定流程框架，代理内部保留创造性空间；
• 人工介入点：关键节点（如审查、设计确认）可配置人工介入；
• 错误处理：失败时重试、回滚或升级人工处理；
• 并行串行协调：独立功能并行开发，依赖功能串行执行。

Agent Garden的价值在于提供可复现、可扩展的AI辅助开发工作流模式。适用场景包括：

• 标准化开发流程：建立团队统一规范；
• 重复性任务自动化：模板化相似功能开发；
• 快速原型开发：快速验证想法到可运行代码；
• 学习教学：展示AI辅助开发最佳实践。项目处于早期阶段，核心理念清晰，是探索多代理协作开发的参考架构。