SuperTeam：Claude Code的多智能体交付框架与质量门控实践

本文解析SuperTeam框架如何解决AI辅助开发中"依赖模型自律保证质量不可靠"的核心矛盾。通过七阶段交付工作流与Python钩子机制，将软件质量约束从"智能体自律"转变为"物理强制执行"，实现AI驱动开发的可靠交付。框架适用于Claude Code团队开发，其核心理念对传统开发流程也具参考价值。

SuperTeam V4.5.0及更早版本依赖.md文件中的质量规则与编排器自我监督执行，但事后诊断发现致命缺陷：编排器可理性化跳过审查/验证步骤（如狐狸看守鸡舍）。V4.6.0将执行机制转移到Python钩子（注册于~/.claude/settings.json），运行在Claude推理链之外，实现物理强制约束，无法被理性化绕过。

SuperTeam定义G1-G7七阶段交付流程，各阶段有明确进入/退出标准：

• G1：需求澄清与规划，产出带分类ID（F/UI/API/MIG）的plan.md，确保需求可追踪；
• G2：架构与技术方案，预先识别技术债务并制定缓解策略；
• G3：实现与编码，通过钩子强制执行TDD红/绿状态机（先记录失败测试再写生产代码）；
• G4-G7：验证（verification.md需PASS）、审查（问题需在finish.md确认）、部署（git操作阻塞除非验证通过）、复盘（retrospective.md需含改进行动），且G4-G7自动链式执行无需用户确认。

V4.6.0核心创新是钩子级强制约束，包括：

1. TDD红/绿状态机：追踪测试状态，仅解决失败测试后可编辑生产代码；
2. Plan MUST会计机制：plan.md中每个MUST项需在execution.md有对应证据，确保无遗漏；
3. 编排器决策日志：生成执行器/审查器前需记录决策章节，单元ID需存在且未完成；
4. 入口日志对账：下游智能体需逐字重述plan中的MUST项，不匹配则阻塞；
5. 提交门控：git提交阻塞除非verification.md带PASS判决，finish.md需确认审查问题，retrospective.md需有改进行动。

SuperTeam引入plan-progress.json记录MUST项状态（COMPLETE/PENDING/BLOCKED），支持中断恢复、进度可视化、阻塞识别。此外还有两个特色模块：

• 前端美学流水线：定义UI/UX美学标准检查清单（色彩一致性、排版规范等）；
• 团队行为审计：通过日志与复盘文档生成报告，揭示协作系统性问题（如需求偏差）。

SuperTeam的设计哲学带来四点启示：1. 从自律到他律，用技术机制强制质量标准；2. 物理约束优于流程文档；3. 可追溯性是质量基础；4. 自动化闭环提升一致性与效率。结语：SuperTeam代表AI辅助开发从"智能助手"到"质量基础设施"的演进方向，为Claude Code团队开发提供实战框架，其核心理念对传统开发同样适用。