目录

Spec Kit:GitHub官方推出的规范驱动开发工具包,让规格文档直接生成代码

Spec Kit:GitHub官方推出的规范驱动开发工具包,让规格文档直接生成代码

项目概览

Spec Kit 是 GitHub 官方维护的开源项目,星数高达 98,770,Forks 8,600,是今日 Trending 榜的明星项目。项目的核心主张是:规范驱动开发(Spec-Driven Development)——将规格文档从「写了就扔掉的架子」变成「直接生成代码的可执行资产」。

传统开发流程是:先写规格,然后编码,规格在这个过程中往往被束之高阁。Spec Kit 翻转了这个逻辑:规格不仅指导开发,而且直接生成可工作的实现

核心概念:规范驱动开发

Spec-Driven Development 的核心是让产品规格(Spec)变成可执行的。具体来说:

  1. 写规格优先:在写任何代码之前,先把需求写成规格文档
  2. 规格可执行:规格文档不是死的说明文,而是能直接生成代码的模板
  3. AI 参与生成:AI 编码 Agent(Copilot、Claude Code 等)根据规格直接产出代码
  4. 规格即文档:生成的代码和规格文档始终保持一致,无需额外维护

Specify CLI

Spec Kit 的核心工具是 Specify CLI,通过 uv(或 pipx)安装:

# 安装稳定版(推荐,先查看 Releases 获取最新 tag)
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z

# 或安装最新版(可能包含未发布变化)
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

# 验证安装
specify version

# 初始化新项目
specify init <PROJECT_NAME>

# 在现有项目中初始化
specify init . --integration copilot

核心功能

项目初始化与检查

# 检查已安装工具
specify check

# 创建新项目
specify init my-project

# 指定 AI 集成
specify init --here --integration copilot

支持的AI编码Agent

Spec Kit 官方支持多种 AI 编码 Agent 的集成,包括但不限于 Copilot(Claude、GitHub Copilot 等)。通过 --integration 参数在初始化时指定。

社区扩展与预设

  • 🧩 社区扩展(Extensions):扩展 Specify CLI 功能的插件
  • 🎨 社区预设(Presets):预置的规范模板,覆盖特定场景
  • 🚶 社区演练(Walkthroughs):逐步指南,帮助上手
  • 🛠️ 社区工具(Friends):与 Specify 配合使用的第三方工具集成

技术细节

  • 语言:Python
  • 安装方式:仅通过 GitHub 发布,不在 PyPI 上发布官方包(PyPI 上同名包与本项目无关)
  • 包管理器:推荐使用 uv
  • 文档:托管在 GitHub Pages github.github.io/spec-kit

开发阶段

Spec Kit 在 README 中提到了多个开发阶段,从基础工具到完整工作流,体现了项目的长期规划。官方也列出了实验性目标(Experimental Goals),展示了项目的发展方向。

适用场景

  • 需要将产品规格文档变成可执行代码的团队
  • 希望统一团队编码规范、减少「vibe coding」的工程团队
  • 使用 AI 编码 Agent 但希望有更强结构约束的项目
  • 追求「先规格、后实现」开发流程的开发者

延伸阅读官方文档 · GitHub 仓库 · Specify CLI 安装指南