spec-kit：GitHub 官方推出的规格驱动开发工具包

项目简介

spec-kit 是 GitHub 官方开源的规格驱动开发（Spec-Driven Development）工具包。与传统软件开发以代码为核心、规格文档作为辅助的做法不同，spec-kit 彻底翻转了这个模式——规格文档变成可执行的，直接生成可工作的实现代码，而不是仅仅指导实现过程。

spec-kit 的核心是 Specify CLI 工具，帮助开发者在编写代码之前，先用声明式规格文档描述系统的预期行为，然后由工具自动生成高质量的代码框架和实现。规格文档本身成为交付物的一部分，而非用完即弃的临时文档。

GitHub 官方出品，87K+ 星标，支持所有主流 AI 编程智能体，MIT 协议开源。

核心特色功能

规格文档可执行化： 传统规格文档是给人看的，spec-kit 的规格文档可以直接被工具解析并用于生成代码，实现了”规格即实现”的范式转变。

Specify CLI 工具链：
– specify init：初始化项目规格结构
– specify check：验证实现是否符合规格
– specify generate：根据规格生成代码框架
– specify diff：比较规格与实现的差异

AI 智能体原生支持： spec-kit 经过专门设计，Claude Code、Cursor、Copilot 等主流 AI 编程工具都能理解并处理规格文档，让 AI 始终知道自己要做什么、验收标准是什么。

社区扩展生态： 支持自定义扩展（Extensions）和预设（Presets），可以导入社区开发的规格模板，覆盖 Web 开发、移动端、API 设计、数据处理等多种场景。

视频教程和文档： 提供完整的 GitHub Pages 文档、视频概述和社区开发的演练指南，上手非常友好。

规格校验和质量门控： 内置自动化检查，确保代码实现始终与规格保持同步，任何偏离规格的变更都会被标记。

安装步骤

前置要求：
– Python 3.10+
– uv 包管理器（推荐）或 pip

方式一：uv 安装（推荐）

“`bash

安装最新稳定版（推荐固定版本号）

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
“`

方式二：pip 安装

bash
pip install specify-cli

方式三：Homebrew 安装（macOS/Linux）

bash
brew install github/spec-kit/specify-cli

安装完成后验证：

bash
specify --version

使用方法

第一步：初始化项目规格

bash
specify init my-project
cd my-project

这会创建一个包含规格模板的目录结构：

my-project/
├── SPEC.md # 主规格文档
├── specs/ # 子规格模块
├── generated/ # 生成的代码输出目录
└── specify.yml # 项目配置

第二步：编写规格文档

在 SPEC.md 中用声明式语法描述系统行为：

“`markdown

用户认证系统规格

功能

用户注册

• 用户输入邮箱和密码即可注册
• 密码必须至少 8 位，包含数字和字母
• 注册成功后自动登录

用户登录

• 支持邮箱 + 密码登录
• 登录成功后返回 JWT token
• 连续 5 次登录失败需等待 5 分钟

验收标准

1. 新用户可以在 30 秒内完成注册
2. 密码强度不足时返回明确错误提示
3. JWT token 有效期为 24 小时
   “`

第三步：生成代码框架

bash
specify generate --spec SPEC.md --output ./generated

这会根据规格生成对应的代码结构（API 路由、数据模型、验证逻辑等）。

第四步：AI 辅助实现

在 Claude Code 或 Cursor 中，加载项目规格：

请根据 SPEC.md 中的规格，实现完整的用户认证系统，确保所有验收标准都得到满足。

第五步：验证实现

bash
specify check --spec SPEC.md --impl ./src

如果有任何实现偏离规格，specify 会报告具体差异。

第六步：规格与代码同步更新

当需求变更时，更新 SPEC.md，然后重新运行：

bash
specify diff --spec SPEC.md --impl ./src

specify 会高亮显示需要更新的代码部分。

社区预设（Community Presets）

spec-kit 生态包含大量社区开发的预设，覆盖常见场景：

预设名称	适用场景
api-design	RESTful API 设计
react-component	React 组件开发
python-cli	Python 命令行工具
data-pipeline	数据处理管道
microservice	微服务架构

安装社区预设：

bash
specify preset install api-design

适用人群

• 追求代码质量的团队：规格文档不再是事后补的负担，而是驱动开发的中心。
• AI 编程工具重度用户：规格文档给 AI 提供了清晰、无歧义的任务描述，大幅提升 AI 生成代码的准确性。
• 需求变更频繁的项目：规格驱动确保每次变更都有清晰的记录和验证。
• 规范意识强的企业：规格文档可作为合同级别的交付物和验收依据。

开源协议

MIT License，由 GitHub 官方维护和持续更新。

---

spec-kit 的核心洞察是：传统开发中规格文档与实现代码的脱节是 Bug 和返工的主要来源。让规格可执行化，使文档和代码永远保持同步，是从根本上解决这个问题。2026 年 AI 编程时代，这或许是代码质量保证的新范式。

---

服务支持：如有兴趣不会搭建，可以联系微信：WRYD6166，开源项目搭建10-50元。