Claude Code FSM工作流：22个智能体协同的自动化工程流水线

本文介绍claude-code-fsm-workflow项目，该项目通过有限状态机（FSM）架构将Claude Code转变为完整的自动化工程流水线，实现从需求分析到代码交付的全流程自动化。核心特点是22个专门化子智能体协同工作，并通过机械式钩子强制角色分离与流程管控，解决AI智能体协同中的偏离主题、上下文重复读取、代码矛盾等问题。

该工作流由Google Compute Engine上运行Telegram机器人集群的开发者设计并验证。核心问题：AI智能体易在长对话中偏离主题、重复读取上下文、写出矛盾代码；传统软性约束效果有限。设计哲学：采用机械式强制，通过系统级钩子确保规则执行，而非依赖智能体自我约束。

工作流拆解软件开发流程为22个独立子智能体，分5类：

• 规划阶段：spec-writer（需求转技术规格）、research-scout（调研代码库与prior art）、architect（生成构建清单）、task-planner（拆解原子任务并生成MAP.md）；
• 执行阶段：fsm-executor（按依赖执行编码任务）、fsm-integrator（跨任务集成）、dispatcher（调度顺序与并行）；
• 质量保障：code-auditor（静态分析）、bug-scanner（缺陷扫描）、dep-checker（依赖验证）、code-fixer（机械化修复）、debugger（复杂调试）、test-runner（测试执行）；
• 探索与验证：explore-scout（并行读代码）、explore-superscout（深度分析）、file-lister（文件系统交互）、mock-server（模拟服务）、mockup-verifier（原型验证）；
• 会话管理：session-closer（清理任务状态）、session-handoff（状态转移）、doc-writer（生成文档）、code-reviewer（代码审查）。

1. 严格角色分离：通过钩子脚本（如block-map-writes.sh、block-worker-reads.sh）强制：编排器不写代码，工作者不修改任务地图，审计员不修复bug；
2. 无状态工作者：每次轮询从磁盘读取全部信息，无对话记忆，消除信息漂移；
3. 随机数验证读取：任务文件带nonce，工作者需回显nonce以证明读取，防止依赖幻觉或过时信息；
4. 纪律门禁系统：.py/.ts文件写入需经discipline-gate.sh检查，违反编码规范则阻止写入并返回错误，智能体自动修正。

流程分10步：

1. 头脑风暴：开发者与编排器讨论需求，调用spec-writer或research-scout；
2. 触发构建：开发者说"build it"，调度器启动流水线；
3. 并行侦察：explore-scout等并行读取代码库生成分析报告；
4. 架构综合：architect生成结构化构建清单；
5. 原子任务规划：task-planner生成MAP.md，含任务描述、输入/输出文件、依赖、nonce；
6. 波浪式执行：fsm-executor和integrator按依赖波浪执行，编排器更新MAP.md状态；
7. 并行审计：code-auditor、bug-scanner、dep-checker并行审查；
8. 修复循环：code-fixer和debugger迭代处理问题至通过检查；
9. 测试验证：test-runner执行测试套件；
10. 会话清理：session-closer重置MAP.md并删除临时文件。

安装方式：

• 手动安装：运行install.sh（幂等，验证依赖、备份设置、复制文件、设置权限等）；
• 委托安装：粘贴INSTALL_FOR_CLAUDE.md内容到Claude Code，让另一个实例完成。 使用步骤：cd到项目目录 → 运行claude → 执行/init-workflow初始化项目。 适用场景：大型代码库增量开发、严格质量要求项目、团队协作环境、可重复流程场景、长周期项目。

该项目展示AI辅助编程从单一智能体对话式向多智能体流水线式转变。核心启示：

• 机械式强制优于软性约束：系统级执行比智能体自觉更可靠；
• 状态外置优于内置：磁盘保存状态避免上下文丢失，实现跨会话持久化；
• 角色专业化优于全能型：拆解任务降低认知负荷，提升可靠性。对团队提升AI辅助开发效率有借鉴价值。