OpenSpec 三阶段工作流实操：从 Propose 到 Archive让代码返工率降到三分之一以下

SDD（规范驱动开发）和传统的前期文档区别不在于写什而在于谁来读它。传统文档写给人看的，而SDD 规范写给 AI agent 看，其结构让模型能够在生成过程中引用它、对照它检查输出、在一个 session 结束、新 session 开始时借此恢复上下文。

为什么选 OpenSpec

我评估过两个主要的开源方案——GitHub 的 SpecKit 和 Fission-AI 的 OpenSpec。

SpecKit 有一个 constitution模型，能把跨领域的规则（TDD 要求、编码标准、合规约束）编码进每一个功能的工作流中；对企业合规场景这个很不错。OpenSpec 是另一个方向：三个命令，不需要事先写 constitution，开箱即用支持 25 个以上的 AI 工具。它对每份规范都有一个硬性的 50KB 上下文限制——这一点为什么重要，后面会展开说。

作者用的是 Claude Code、偶尔用 Cursor，所以OpenSpec 更适合我这种场景。不过如果你在受监管的行业，需要强制执行"每个 API 端点都必须有 OpenAPI 文档"这类规则，SpecKit 的 constitution 模型可能更合适，这是一个合理的取舍，并没有对错之分。

三阶段工作流

OpenSpec 强制执行一个严格的状态机，没有任何阶段可选，也没有任何阶段能跳过。下面是它实际的运作方式。

 

https://avoid.overfit.cn/post/548f7f8356d04034a0cfce29ebc66670