GitHub Spec-Kit：规范驱动开发指南 Spec-Driven Development

阅读时间 9分钟
English Version

什么是 Spec-Driven Development

2026年5月14日 GitHub 发布了 spec-kit 一个开源的规范驱动开发工具包 几小时内就获得了 99,000+ Stars 成为 GitHub 史上增长最快的仓库之一

Spec-Driven Development（规范驱动开发）彻底翻转了传统的代码优先模式 不是先写代码再补文档 而是先写可执行的规范 再由 AI 根据规范自动生成代码 规范不再是单独的文档 而是驱动整个开发过程的权威来源

官方口号是："专注于产品场景和可预测的结果 而不是从零开始 vibe coding 每一段代码"

工作流程

Spec-Kit 通过 specify CLI 工具和一系列斜杠命令工作 分为五个阶段：

1. Constitution 设定规则

在写任何代码之前 先定义项目的核心原则 这就是"为什么"——代码质量标准 测试要求 UX 一致性指南 性能目标 这些规则贯穿整个开发周期 确保 AI 智能体始终与你的意图保持一致

specify init my-project --integration copilot
cd my-project
/speckit.constitution 设定专注于代码质量
  测试标准 用户体验一致性
  和性能要求的原则

2. Specify 描述做什么而不是怎么做

用自然语言描述你要构建什么 关键是关注 什么和为什么 而不是技术栈 这迫使你在进入实现细节之前先把产品逻辑想清楚

/speckit.specify 构建一个帮我组织照片的应用
  可以按日期分组相册 通过拖拽重新排序
  相册不能嵌套 每个相册里的照片以网格预览

3. Plan 选择技术栈

现在指定实现方案——技术栈 架构决策 库的选择 AI 会根据规范生成可执行的计划

/speckit.plan 使用 Vite 最少的外部库
  尽量用原生 HTML CSS JavaScript
  图片不上传服务器 元数据存本地 SQLite

4. Tasks 拆解任务

Spec-Kit 从计划中生成结构化的任务列表 粒度清晰 可以独立执行

/speckit.tasks

5. Implement 执行

运行所有任务 根据计划完整构建功能 AI 智能体逐一执行 生成完整的实现代码

/speckit.implement

支持的 AI 编码智能体

Spec-Kit 从设计上就是为 AI 编码时代打造的 支持多个智能体：

智能体 命令语法 状态
GitHub Copilot/speckit.*主要集成
Claude Code/speckit.*斜杠命令
Codex CLI$speckit-*Skills 模式
其他智能体可配置社区扩展

无论你使用哪个 AI 编码智能体 规范优先的工作流都是一致的 规范（而不是 AI 智能体）成为项目的权威文档

架构设计

Spec-Kit 是一个可扩展的平台 不是一个大一统的工具：

社区扩展

第三方开发者可以创建扩展 添加新的命令 钩子和功能 这些扩展独立维护 通过目录发布

社区预设

预设可以自定义 Spec-Kit 的行为——覆盖模板 命令和术语 而不改变底层工具 例如 团队可以创建 "React" 预设 自动生成 React 特定的规范

社区教程

社区贡献的端到端指南 展示规范驱动开发在不同场景和技术栈中的应用

为什么重要：告别"Vibe Coding"？

AI 编码智能体的兴起带来了一个现象叫 "vibe coding"——对 AI 描述一个高层目标 然后接受它生成的所有内容 没有深入理解也没有规范 这种方式原型开发很好用 但给生产软件带来了问题：

  • 没有可验证的规范 — 必须逐行审查生成的代码 因为没有规范对照
  • 架构不一致 — 每次重新生成 AI 都会做不同的架构选择
  • 决策不可见 — AI 的实现选择对人类开发者是黑箱
  • 迭代困难 — 没有规范 你怎么知道修改是否破坏了原始意图？

规范驱动开发解决了所有这些问题：规范是权威文档 AI 不决定构建什么 它只负责实现已经明确规范的内容

这对团队尤其有优势：规范成为产品经理 设计师 工程师和 AI 智能体之间的共享语言 所有人都基于同一份文档工作

快速上手

安装 Spec-Kit 需要 uv (Astral 的 Python 包管理器)：

uv tool install specify-cli --from \
  git+https://github.com/github/spec-kit.git@v0.1.0

然后初始化项目：

specify init my-project --integration copilot
cd my-project

之后在你的 AI 编码智能体的聊天界面中使用 /speckit.* 命令 详细流程在 GitHub 官方仓库 和 Spec-Kit 文档站 中有完整描述

与其他方法对比

  • vs. TDD 测试驱动开发 — TDD 通过测试指定行为 SDD 通过结构化描述指定产品意图 两者互补：SDD 确定构建什么 TDD 验证正确性
  • vs. BDD 行为驱动开发 — BDD 使用 Gherkin 语法（Given/When/Then）SDD 使用结构化自然语言 SDD 专门为 AI 智能体时代设计
  • vs. 传统文档 — 普通规范只能阅读 SDD 规范可执行 直接生成实现和测试
  • vs. Vibe Coding — Vibe coding 没有规范 SDD 要求必须先写规范 前期更慢 但结果更可预测 更易维护

为什么几小时就 99K Stars？

spec-kit 的爆发式增长反映了开发者社区的迫切需求 随着 AI 编码智能体成为主流 开发者意识到瓶颈根本不是代码生成——而是规范制定 没有规范的 AI 智能体就像没有需求文档的开发者：它能产出东西 但可能不是你想要的

GitHub 将其标准化为工具包并开源 是解决 AI 辅助开发现阶段最大痛点的战略举措

总结

GitHub Spec-Kit 代表了一种真正的范式转变 它认识到在 AI 写代码比人类审查更快的时代 瓶颈已经从"写代码"转移到了"明确意图" 通过让规范变得可执行 并直接集成到 AI 编码智能体中 Spec-Kit 将规范驱动开发的纪律带到了 AI 生成代码的时代

Spec-Driven Development 能否像 TDD 或 DevOps 一样成为基础性实践 取决于社区的采用 但有一点是确定的：一场重要的讨论已经开始 而一天之内 99,000+ 开发者的关注 是一个强烈的信号

← 返回博客