MageByte-Zero/spec-superflow

它解决了什么问题

AI 编程助手常常在需求尚未完全理解时就开始编写代码，或在实现过程中偏离原始计划。spec-superflow 通过引入基于风险的工作流，强制在执行前对需求和设计达成一致，尤其适用于高风险变更，同时对简单修改保持轻量级。

它如何工作

该项目提供了一套「技能」和一个 CLI 工具链，可集成到各种 AI 助手（如 Claude Code、Cursor、Windsurf 等）中。它使用内容级状态机，将 AI 引导至八个不同阶段：

1. 探索：通过 need-explorer 技能澄清需求。
2. 规范：通过 spec-writer 创建提案、规格、设计和任务。
3. 衔接：通过 contract-builder 自动将这些成果压缩为 execution-contract.md。
4. 执行：通过 build-executor 使用 TDD 和子代理驱动开发（SDD）实现代码。
5. 调试：若实现失败，通过 bug-investigator 进行根本原因分析。
6. 评审：通过 code-reviewer 进行结构化代码评审。
7. 收尾：通过 release-archivist 和 spec-merger 完成并归档。

根据风险等级（文件数量、对 API/权限的影响），系统会在 完整路径（所有阶段）和 快速/热修复/微调路径（最小化文档并直接验证）之间进行选择。

适用人群

从事大规模功能开发、多人协作项目或长期维护项目，需要严格 TDD 和评审门禁的开发者。

主要亮点

• 多平台支持：兼容 19 种不同的 AI 编程平台，包括 Cursor、Claude Code、Windsurf 和 GitHub Copilot。
• 基于风险的路由：根据变更复杂度自动选择轻量级或全面的工作流。
• 受保护的执行：高风险变更必须在关闭前通过验证的执行计划和评审凭证。
• 内容级检测：基于成果的实际内容追踪状态，而非文件时间戳。
• 集成 CLI：包含强大的工具链（ssf），用于管理检查点、交接和 git 隔离。