说实话,我被「vibe coding」坑过。
去年有个项目,需求一股脑丢给 AI,一顿 prompt 猛如虎,三天后回头看代码,重复代码没抽离、各种any大法好、公共方法未复用、代码规范和风格不统一、字典枚举取值直接写死,...,,反正就是各种不规范,功能测试验证?也是不存在的。那一刻才意识到:不是 AI 不够强,是我没给 AI 一个「工程框架」。
直到我遇到 SDD(Spec-Driven Development,规范驱动开发),一切才清晰起来。
Thoughtworks 在 2025 年的 Technology Radar Vol. 32 里,把 SDD 列为「值得采用」的技术实践。Martin Fowler 撰文背书。GitHub、Amazon 直接下场做工具。背后逻辑其实很简单:
# vibe coding 的崩溃链: 随意 prompt → AI 自由发挥 → 架构漂移 → 上下文丢失 → 反复返工 → 债台高筑 # SDD 的修复路径: 明确规范 → 技术方案 → 任务拆分 → 受控实现 → 可追溯验证
这一思想在过去 12 个月里已从「博客观点」变成「行业默认」。接下来,我们直接用 GitHub 最新数据来拆解四套主流实现方案。
specify self upgrade 原地升级,无需重装Spec Kit 是 GitHub 官方在 2025 年 9 月开源的工具,核心 CLI 叫 specify。它把软件开发强制拆成四个阶段,每个阶段生成结构化文档,全部进入版本控制,与代码共生:
# 安装最新版 v0.9.3 uv tool install specify-cli \ --from git+https://github.com/github/spec-kit.git@v0.9.3 # 初始化项目(新增:指定 AI 代理集成) specify init my-project --integration copilot cd my-project # 【v0.9.3 新功能】自我升级管理 specify self check # 检查是否有新版本(只读,不做任何修改) specify self upgrade # 原地升级到最新稳定版 specify self upgrade --tag v0.9.3 # 或者固定某个版本 # 支持 30+ AI 代理,7 个核心斜杠命令: /speckit.specify → /speckit.plan → /speckit.tasks → /speckit.implement
大型团队多人协作 · 有合规审查要求(金融/医疗)· 长期维护系统 · 支持 30+ AI 代理(Copilot、Claude Code、Gemini CLI、Cursor、Windsurf 等)· 绿地与存量项目均适用
.kimi/skills/,通过 /skill:openspec-* 调用.vibe/skills//opsx:sync 命令openspec update 与 Dagster 等自带 workspace.yaml 的项目冲突问题OpenSpec 的哲学是:把复杂性锁进变更本身,而不是整个系统。每次功能开发都是一个独立的「变更包」,完成后归档,绝不污染主文档。它是目前唯一明确以 Brownfield(存量系统)为第一优先级的 SDD 工具。
# 安装最新版 v1.4.1 npm install -g @fission-ai/openspec # 初始化(约 5 分钟上手) openspec init # 核心工作流(支持 25+ AI 助手) /opsx:new # 新建变更包 → 生成 proposal.md /opsx:continue # 继续上次未完成的变更 /opsx:verify # 验证实现是否符合规范 /opsx:sync # 【v1.4.0 新增,默认开启】同步技能文件 /opsx:archive # 归档变更,合并入主文档 # Kimi CLI 集成(v1.4.0 新增) openspec init --integration kimi # skills → .kimi/skills/ # 在 Kimi CLI 中调用:/skill:openspec-new 等
接手老项目重构 · 中小团队快速迭代 · 完整变更审计 · Token 使用效率优先 · 现已支持 Kimi CLI、Mistral Vibe 等新平台
/brainstorm、/execute-plan、/write-plan 全部删除,直接调用对应 SkillSuperpowers 不把规范当「文档」,而是当「技能(Skill)」。AI Agent 执行任何任务之前,自动检测并触发对应的 Skill。TDD 是不可跳过的强制流程,技能触发是上下文匹配的,不需要用户手动输入命令。
# 在 Claude Code 中安装(v5.1.0 已支持 OpenAI Codex) /plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace # 重启后自动生效,无需任何命令 # v5.1.0 重要变化:旧命令已移除 # ❌ /brainstorm → ✅ 直接描述需求,自动触发 # ❌ /execute-plan → ✅ superpowers:executing-plans # ❌ /write-plan → ✅ superpowers:writing-plans # 使用示例(直接对话,无需命令) 你:"给 API 加一个限流功能" → 自动触发 Brainstorm Skill,开始苏格拉底提问... → 设计方案呈现 → 等待你确认... → 自动 git worktree → 子 Agent 并行实现...
长时间自主运行(Multi-hour sessions)· 复杂功能并行执行 · 独立开发者极致效率 · 重度使用 Claude Code / OpenAI Codex 的用户
curl -fsSL https://cli.kiro.dev/install | bash 一键安装,支持终端直接使用 /plan 命令Kiro 把 SDD 内置为 IDE 的第一公民,引入三大独特机制:Steering 护栏文件(约束 AI 行为边界)、Spec 三件套(需求/设计/任务)、Kiro Hooks(事件驱动的常驻后台 Agent)。现在还新增了 Kiro Web 和 Kiro CLI 两个轻量化入口。
# 方式一:IDE(完整功能) # 下载地址:kiro.dev → Download IDE kiro init # 方式二:CLI(新增,终端使用) curl -fsSL https://cli.kiro.dev/install | bash kiro-cli /plan # 切换到 Plan agent,开始规范驱动 # 方式三:Kiro Web(浏览器,新上线) # 直接访问 web.kiro.dev,无需安装 # Steering 护栏示例(约束 AI 行为) # .kiro/steering/standards.md Always use TypeScript strict mode All API endpoints MUST have input validation Database queries MUST use parameterized statements Tests MUST cover happy path and error cases # Hooks 示例(事件驱动后台 Agent) # .kiro/hooks/onSave.md # 每次保存文件 → 自动触发安全扫描 # .kiro/hooks/onCommit.md # 每次提交代码 → 自动更新架构图
企业级项目强约束 · AWS 生态深度集成 · 需要 Hooks 自动化合规检查 · 从 vibe coding 迁移到规范化开发 · 现在还可通过 Kiro Web 零安装体验
📡 数据来源:直接抓取 GitHub 仓库 + kiro.dev 官网,截止 2026 年 6 月 4 日
| 对比维度 | 🔷 Spec Kit | 🟠 OpenSpec | ⚡ Superpowers | 🟡 AWS Kiro |
|---|---|---|---|---|
| GitHub ⭐(实时) | 108K | 52.8K | 217K 🏆 | 商业产品 |
| 最新版本 | v0.9.3 (Jun 3) | v1.4.1 (Jun 3) | v5.1.0 (May 4) | Opus 4.8 / Kiro Web |
| 学习曲线 | 陡 | 极平缓 🏆 | 低(对话即用) | 中等 |
| 启动时间 | ~30 分钟 | ~5 分钟 🏆 | ~5 分钟 | ~15 分钟 |
| Token 消耗 | 高(18K+/功能) | 中(最省) | 高(多 Agent) | 中 |
| TDD 强制 | 可选 | 可选 | 强制 ✓ 🏆 | 可选 |
| 存量系统 | 良好 | 最佳 🏆 | 一般 | 良好 |
| 团队治理 | 完善 | 中等 | 较弱 | 最强(Steering)🏆 |
| 自动化 Hooks | 无 | 无 | 部分 | 原生支持 🏆 |
| AI 代理支持数 | 30+ 🏆 | 25+(新增 Kimi) | ~6 一线平台 | 内置(Opus 4.8) |
| 最适合人群 | 大团队/合规项目 | 中小团队/存量改造 | 独立开发者/极客 | 企业/AWS 用户 |
经过实际使用,用这个决策框架快速定位:
回到最开始——被 vibe coding 坑惨的那次。SDD 带来的改变非常具体:
换模型(比如 Sonnet 换 Opus 4.8)、换会话,AI 读 spec 文件立刻续接,不用重新解释背景。
每行代码都能追溯到 spec 里的哪条需求。Review 时心里有底,出了问题知道从哪查。
不再是「我以为你要这个」,而是「spec.md 第 3 条写的是这个」。消除歧义,减少内耗。
问题在规范阶段暴露,比在代码阶段暴露便宜至少 10 倍。前期慢,是为了后期不崩。
SDD 最核心的价值:人类负责「想清楚要做什么」,AI 负责「把它做出来」。规范文档是人类保持架构主导权的最重要工具。随着 AI Agent 越来越强,这份「掌舵权」只会越来越珍贵。