spec-superflow

spec-superflow - AI编程工作流插件，需求规划、契约执行与代码审查工具

spec-superflow 简介

spec-superflow 是一款连通"需求说清楚"与"代码写对路"的AI编程工作流插件，由 MageByte-Zero 开发并开源在GitHub上。插件源码级融合 OpenSpec 规划引擎与 Superpowers 执行纪律，将需求澄清、规范撰写、契约生成、TDD执行、代码审查等9个技能整合为自包含的工作流引擎。支持 Claude Code、Cursor、OpenAI Codex CLI/App、GitHub Copilot CLI、Gemini CLI 等7大AI编程平台，通过"Spec-first"与"Guarded Handoff"原则，在AI写代码的两个失控点（需求不清、执行跑偏）之间建立硬约束。

spec-superflow 核心功能/服务

8状态机工作流引擎：从需求探索（need-explorer）到规范撰写（spec-writer）、契约生成（contract-builder）、执行总督（build-executor）、调试调查（bug-investigator）、代码审查（code-reviewer）、收口归档（release-archivist）到规范同步（spec-merger），形成完整的规划-执行-审查-归档闭环。没有 execution-contract.md 或未经用户批准，不允许进入实现阶段。

源码级Schema验证：内置OpenSpec引擎，对proposal、specs、design、tasks等规划工件进行Schema验证。每个Requirement必须含SHALL/MUST，每个Scenario必须有Given-When-Then，不合格即拒绝进入下一环节，从源头防止需求模糊导致的代码返工。

智能模式检测与快速路径：v0.7.0起支持自动模式检测，根据变更规模自动判断hotfix（≤2文件）、tweak（≤4文件配置修改）或full完整流程。小变更自动走轻量流程，不拖慢开发节奏；大变更强制走完整规划-契约-执行链路，确保质量可控。

spec-superflow 适合谁

• 大型项目开发团队：需要明确规划、审查门禁与测试纪律的技术团队，通过spec-superflow的TDD铁律+SDD子代理驱动+Review Gate双重审查，防止实现偏离设计，特别适合多人协作与长期维护项目。
• AI辅助编程用户：使用Claude Code、Cursor、Codex等AI工具但担心需求理解偏差的开发者，借助插件的need-explorer追问机制与execution-contract.md契约层，确保AI在写代码前真正理解需求意图。
• 棕地项目维护者：需要在现有代码库上进行增量开发或重构的维护工程师，通过插件的need-explorer先检查现有代码再规划变更，结合Delta Spec同步机制防止规范腐烂，支持可持续演进。

为什么选择spec-superflow

spec-superflow 不是简单并列安装OpenSpec与Superpowers，而是"去重叠、留异同、加独创"的源码级融合：吸收OpenSpec的Schema引擎、Delta Spec、三维度验证与Superpowers的TDD铁律、SDD子代理、系统化调试、结构化审查，独创contract-builder桥接层将4份规划工件自动压缩为1份可检查契约，独创workflow-start内容级状态检测与8状态路由。插件自包含，无需运行时单独安装上游依赖。CLI工具链（ssf list/validate/doctor/sync等）提供独立于AI会话的项目管理能力。对于"会在团队周会上花5分钟以上解释的改动"，spec-superflow的纪律收益远超流程开销。访问 spec-superflow GitHub仓库，了解AI编程工作流插件详情。