Spec Kit（GitHub 官方规格驱动开发工具包）
🌱 Spec Kit
在动手编码之前，先定义要构建什么 —— 适配任意 AI 编码助手。
<strong>一个开源工具套件，帮助你借助任意 AI 编码助手构建高质量软件 —— 内置开箱即用的规范驱动流程（也可自带流程），可无限扩展、由社区驱动，并为整个组织的协作而设计。</strong>
<strong>简体中文</strong>
目录
- 🤔 什么是规范驱动开发？
- ⚡ 快速开始
- 📽️ 视频概览
- 🌍 社区
- 🤖 支持的 AI 编码助手集成
- 🔧 Specify CLI 参考
- 🧩 打造你自己的 Spec Kit：扩展与预设
- 📦 捆绑包：面向角色的一键配置
- 📚 核心理念
- 🌟 开发阶段
- 🎯 实验目标
- 🔧 环境要求
- 📖 深入了解
- 💬 支持
- 🙏 致谢
- 📄 许可证
🤔 什么是规范驱动开发？
规范驱动开发（Spec-Driven Development）颠覆了传统软件开发的思路。几十年来，代码一直是核心 —— 规范只是编码这项"正事"开始前搭起、随后就被丢弃的脚手架。规范驱动开发改变了这一点：规范本身变得可执行，它不再只是引导实现，而是直接生成可运行的实现。
⚡ 快速开始
1. 安装 Specify CLI
需要 uv（安装 uv）。将 vX.Y.Z 替换为 Releases 中最新的发布标签 —— 记得保留开头的 v（例如 v0.12.11，而不是 0.12.11）：
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z更倾向从 PyPI 安装？specify-cli 包同样发布在那里：
uv tool install specify-cli其他安装方式、安装校验、升级以及故障排查，请参阅安装指南。
2. 初始化项目
specify init my-project --integration copilot
cd my-project要检查更新或升级已安装的 CLI，可使用自管理命令。更详细的场景和自定义选项请参阅升级指南。
# 检查是否有更新版本可用（只读操作 —— 不会修改任何内容）
specify self check
# 预览升级将执行的操作，但不实际升级
specify self upgrade --dry-run
# 就地升级到最新稳定版（自动识别 uv tool 与 pipx 安装方式）
specify self upgrade
# 或锁定到指定的发布标签（将 vX.Y.Z[suffix] 替换为你想要的标签）
specify self upgrade --tag vX.Y.Z[suffix]直接运行 specify self upgrade 会立即执行，与 pip install -U、npm update 等命令一样无需额外确认。对于 uv tool 安装的情况，它在底层会执行 uv tool install specify-cli --force --from <git ref>，因此锁定的发布标签同样有效，包括 dev、alpha/beta/rc 或带构建元数据的后缀。uvx（临时运行）和源码检出会被自动识别，此时会给出针对具体路径的操作建议，而不会执行安装程序。可通过设置 SPECIFY_UPGRADE_TIMEOUT_SECS 来限制安装子进程的最长运行时间（默认无超时限制 —— 必要时用 Ctrl+C 中断）。
3. 确立项目准则
在项目目录下启动你的编码助手。大多数助手将 spec-kit 暴露为 /speckit.* 斜杠命令；处于技能（skills）模式的 Codex CLI 则使用 $speckit-*；GitHub Copilot CLI 使用 /agents 来选择助手，或直接在提示词中指定它。
使用 /speckit.constitution 命令来创建项目的治理准则和开发指南，它们将指导后续所有开发工作。
/speckit.constitution Create principles focused on code quality, testing standards, user experience consistency, and performance requirements4. 编写规范
使用 /speckit.specify 命令描述你想构建什么。聚焦于做什么和为什么做，而不是技术栈。
/speckit.specify Build an application that can help me organize my photos in separate photo albums. Albums are grouped by date and can be re-organized by dragging and dropping on the main page. Albums are never in other nested albums. Within each album, photos are previewed in a tile-like interface.5. 制定技术实现方案
使用 /speckit.plan 命令提供你的技术栈和架构选择。
/speckit.plan The application uses Vite with minimal number of libraries. Use vanilla HTML, CSS, and JavaScript as much as possible. Images are not uploaded anywhere and metadata is stored in a local SQLite database.6. 拆解为任务
使用 /speckit.tasks 从实现方案生成一份可执行的任务清单。
/speckit.tasks7. 执行实现
使用 /speckit.implement 执行所有任务，按方案构建你的功能。
/speckit.implement详细的分步说明，请参阅我们的完整指南。
📽️ 视频概览
想看看 Spec Kit 的实际效果？观看我们的视频概览！
🌍 社区
在 Spec Kit 文档站点上探索由社区贡献的资源：
- 扩展（Extensions） —— 命令、钩子与各类能力
- 预设（Presets） —— 模板与术语覆盖
- 捆绑包（Bundles） —— 由现有组件组合而成的角色与团队技术栈
- 实战演练（Walkthroughs） —— 端到端的 SDD 场景
- 伙伴项目（Friends） —— 扩展 Spec Kit 或基于它构建的项目
NOTE
社区贡献由各自的作者独立创建和维护。请在安装前审阅源代码，并自行斟酌使用。
想要参与贡献？请参阅扩展发布指南、预设发布指南或社区捆绑包指南。
🤖 支持的 AI 编码助手集成
Spec Kit 可与 30 多个 AI 编码助手协作 —— 既包括 CLI 工具，也包括基于 IDE 的助手。完整列表以及相关说明和使用细节，请参阅支持的 AI 编码助手集成指南。
运行 specify integration list 可查看当前安装版本中所有可用的集成。
可用的斜杠命令
运行 specify init 后，你的 AI 编码助手就能使用这些斜杠命令来进行结构化开发。对于支持技能模式的集成，传入 --integration <agent> --integration-options="--skills" 会安装助手技能，而不是斜杠命令的提示词文件。
核心命令
规范驱动开发工作流中必不可少的命令：
| 命令 | 助手技能 | 说明 |
|---|---|---|
/speckit.constitution | speckit-constitution | 创建或更新项目的治理准则和开发指南 |
/speckit.specify | speckit-specify | 定义你想构建什么（需求与用户故事） |
/speckit.plan | speckit-plan | 结合所选技术栈制定技术实现方案 |
/speckit.tasks | speckit-tasks | 生成可执行的实现任务清单 |
/speckit.taskstoissues | speckit-taskstoissues | 将生成的任务清单转换为 GitHub issue，便于跟踪与执行 |
/speckit.implement | speckit-implement | 执行所有任务，按方案构建功能 |
/speckit.converge | speckit-converge | 对照规范/方案/任务评估代码库，并将剩余工作追加为新任务 |
可选命令
用于提升质量与做校验的额外命令：
| 命令 | 助手技能 | 说明 |
|---|---|---|
/speckit.clarify | speckit-clarify | 澄清描述不充分的部分（建议在 /speckit.plan 之前使用；旧称 /quizme） |
/speckit.analyze | speckit-analyze | 跨制品的一致性与覆盖度分析（在 /speckit.tasks 之后、/speckit.implement 之前运行） |
/speckit.checklist | speckit-checklist | 生成自定义质量清单，校验需求的完整性、清晰度与一致性（好比"为自然语言写单元测试"） |
🔧 Specify CLI 参考
完整的命令详情、选项与示例，请参阅 CLI 参考文档。
🧩 打造你自己的 Spec Kit：扩展与预设
Spec Kit 可通过两套互补的机制进行深度定制 —— 扩展（extensions） 和 预设（presets） —— 以及面向单个项目的本地覆盖，用于临时性调整：
| 优先级 | 组件类型 | 位置 |
|---|---|---|
| ⬆ 1 | 项目本地覆盖 | .specify/templates/overrides/ |
| 2 | 预设 —— 定制核心与扩展 | .specify/presets/templates/ |
| 3 | 扩展 —— 新增能力 | .specify/extensions/templates/ |
| ⬇ 4 | Spec Kit 核心 —— 内置 SDD 命令与模板 | .specify/templates/ |
- 模板在运行时解析 —— Spec Kit 从高到低遍历优先级栈，使用第一个匹配项。
- 项目本地覆盖（
.specify/templates/overrides/）允许对单个项目做一次性调整，无需创建完整的预设。 - 扩展/预设命令在安装时生效 —— 当你运行
specify extension add或specify preset add时，命令文件会被写入助手目录（如.claude/commands/）。 - 若多个预设或扩展提供了同一命令，优先级最高的版本生效。移除时，次优先级的版本会自动恢复。
- 若不存在任何覆盖或自定义，Spec Kit 使用核心默认配置。
扩展 —— 新增能力
当你需要 Spec Kit 核心之外的功能时，使用扩展。扩展可引入新命令和模板 —— 例如添加核心 SDD 命令未覆盖的领域特定工作流、集成外部工具，或新增全新的开发阶段。它们扩展了 Spec Kit 能做什么。
# 搜索可用扩展
specify extension search
# 安装扩展