Home

spec-superflow Wiki

欢迎来到 spec-superflow：一个将 OpenSpec 风格的规划与 Superpowers 风格的执行纪律整合为单一、可审计工作流的 AI 编程插件。

它解决两类常见失控：在需求未澄清时直接改代码，以及虽然有规划文档、执行时却缺少测试、评审和范围约束。工作流将澄清、规范、执行契约、实现、调试与收口显式分阶段，并在关键点设置 guard。

从这里开始

• 快速开始 — 用一句话启动一个变更。
• 安装指南 — 按你的 AI 编程平台安装。
• 工作流与状态机 — 理解 8 个状态、fast path 和回退规则。
• 架构设计 — 了解 skills、CLI、验证引擎与平台适配如何协同。
• 工件与执行契约 — 规划工件怎样成为可执行约束。

核心原则

原则	含义
Spec First	先将需求写成可验证的规划工件，再进入实现。
Contract before build	没有经用户批准的执行契约，不允许开始实现。
Evidence over assertion	测试、验证、review receipt 和审计记录是完成的证据。
Explicit recovery	遇到 bug、范围变化或契约漂移时，进入对应状态，而不是在聊天中随意修补。
Portable by design	同一套 9 个 skills 与 runtime 面向 18 个 AI 编程平台。

项目资源

• 仓库主页
• 安装说明
• 更新日志
• 示例变更
• 问题反馈