Spec Kit：为 AI 编码智能体提供结构化流程的工具包
本文目录
🌱 Spec Kit#
用规格来构建、修复缺陷，或评估一个想法——借助你的编码智能体。
English · 简体中文 · 日本語 · 한국어
Spec Kit 是一个开源工具包，为 AI 编码智能体提供结构化流程、可复用模板和有据可查的产出。你可以从现成流程开始，也可以定制，或自带流程。
选择你的流程#
| 你需要什么 | 流程 | 产出 |
|---|---|---|
| 构建一个功能或应用 | 规格驱动开发（Spec-Driven Development，SDD） | 一份贯穿规划、实现与收敛的规格 |
| 诊断并修复异常行为 | 缺陷修复 | 经评估的原因、限定范围的修复，以及有记录的验证 |
| 判断一个想法是否值得投入 | 想法评估 | 有证据支持的 go、clarify 或 stop 决策 |
| 采用或创建不同的流程 | 你自己的流程 | 由可复用原语调整或组装出的流程 |
这些是相互独立的入口，不是强制阶段。SDD 随核心提供；缺陷修复和评估是捆绑扩展，需要时安装；下面的原语让你可以采用或创建其他流程。
能力#
Spec Kit 把即用流程与可组合机制结合起来：
| 能力 | Spec Kit 机制 |
|---|---|
| 连接编码智能体或在它们之间切换 | 集成（Integration） |
| 添加命令、质量门禁或完整流程 | 扩展（Extension） |
| 把流程连接到外部工具或服务 | 扩展 |
| 响应编码智能体生命周期事件 | 扩展运行时事件 |
| 在 Spec Kit 命令之前或之后运行扩展命令 | 扩展钩子 |
| 调整模板、命令、术语或方法论 | 预设（Preset） |
| 强制执行组织或监管标准 | 预设 |
| 为单个项目覆盖模板 | 项目本地覆盖 |
| 自动化提示词、命令、门禁和 shell 任务 | 工作流（Workflow） |
| 修改已安装工作流而无需分叉 | 工作流覆盖层 |
| 为工作流添加可复用的可执行行为 | 工作流步骤 |
| 为某个角色或团队安装精选配置 | 捆绑包（Bundle） |
| 发现社区组件 | 目录（Catalog） |
| 托管已批准组件的私有目录 | 目录 |
| 访问私有目录和组件下载 | 身份认证 |
| 离线工作或在防火墙后工作 | 本地来源与自托管目录 |
| 检查某个命令、模板或脚本由哪一层提供 | 产物清单 |
用 specify extension search、specify preset search、specify workflow search 和 specify bundle search 等命令搜索活动目录。Spec Kit 包含社区目录，组织也可以添加自己的精选来源。目录列表不是审计或背书，安装或运行社区源代码前请先审查。
快速开始#
需要 Python 3.11+、uv，以及 Linux、macOS 或 Windows 上受支持的 AI 编码智能体。
在终端中运行以下命令安装 Spec Kit 并创建项目。本示例使用 GitHub Copilot。
uv tool install specify-cli
specify init my-project --integration copilot
cd my-project安装 Specify CLI 并创建项目后，在项目目录中启动你的编码智能体，然后从下面选择一个流程。
其他配置：
- 安装：固定版本、其他安装器、CI 与故障排查。
- 现有项目：从已有代码开始。
- 其他智能体：集成键与调用语法。
- 升级：更新现有安装。
规格驱动开发#
定义要构建什么、为什么构建，然后把规格转化为计划、任务和可工作的代码。
下面是最小流程。每个项目创建一次 constitution，然后为每个功能重复其余步骤。在智能体的聊天中运行这些技能，而不是在终端里，一次一个，并在继续前审查每个结果。
本示例使用 GitHub Copilot 的默认技能语法。其他智能体请使用其等效调用语法。
/speckit-constitution Create principles focused on code quality, testing, and maintainability.
/speckit-specify Build a photo organizer with albums grouped by date and a tile preview of each album.
/speckit-plan Use Vite with vanilla JavaScript. Keep images local and store metadata in SQLite.
/speckit-tasks
/speckit-implement
/speckit-converge重复 implement 和 converge，直到 converge 报告 Converged。有关澄清、检查清单和一致性分析，参见 SDD 实操指南。
SDD 实操指南 · 命令参考
缺陷修复#
评估原因、修复缺陷，并验证原始症状已解决。无需先走 SDD 功能流程。
在终端中、从项目目录安装缺陷修复扩展：
specify extension add bug在智能体的聊天中运行这些技能，而不是在终端里，一次一个，并在继续前审查每个结果。
本示例使用 GitHub Copilot 的默认技能语法。其他智能体请使用其等效调用语法。
/speckit-bug-assess "Submitting an empty password crashes the login form." slug=login-crash
/speckit-bug-fix slug=login-crash
/speckit-bug-test slug=login-crash审查 .specify/bugs/login-crash/ 中的报告。最终结论为 verified、partial 或 failed；只有 verified 才确认修复成功。
缺陷修复实操指南 · 命令参考
想法评估#
收集证据，判断一个想法是否值得推进。无需源代码或 SDD 功能流程。
在终端中、从项目目录安装评估扩展：
specify extension add assess在智能体的聊天中运行这些技能，而不是在终端里，一次一个，并在继续前审查每个结果。
本示例使用 GitHub Copilot 的默认技能语法。其他智能体请使用其等效调用语法。
/speckit-assess-intake "Let users work offline and sync when they reconnect." slug=offline-mode
/speckit-assess-research slug=offline-mode
/speckit-assess-define slug=offline-mode
/speckit-assess-shape slug=offline-mode
/speckit-assess-decide slug=offline-mode审查 .specify/assessments/offline-mode/ 中的产物和最终决策：go、needs-clarification 或 kill。通过直接编辑或借助智能体编辑现有 Markdown 产物来解决未知项，而不是重跑整个阶段。如果你选择以 go 决策构建某个软件想法，先按需建立项目 constitution，然后把 decision.md 中的交接摘要传给 /speckit-specify。带着有记录的理由停下来，同样是有用的结果。
评估实操指南 · 命令参考
定制或自带流程#
定制规格驱动开发、缺陷修复或想法评估，以适配你团队的标准。或者自带流程，而不采用上述任何一个。组合下面的能力来匹配你的目标：
- 用预设调整现有流程，例如要求在计划中实现监管可追溯性。对一次性的模板修改使用项目本地覆盖。
- 通过扩展添加自己的流程命令，并通过集成把它们暴露给编码智能体。
- 在工作流中自动化命令和检查。用覆盖层调整已安装工作流而无需分叉，或在内置类型不够时添加自定义工作流步骤。
- 通过把扩展、预设、工作流和工作流步骤打包成捆绑包，分享可复用配置。
从满足需求的最小改动开始；你不必替换整个流程。
定制指南 · 社区组件与实操指南
文档#
- CLI 参考与流程命令
- 将 Spec Kit 应用于项目工作的操作指南
- SDD 理念、完整方法论，以及演进现有规格
- 项目历史
- Spec Kit 如何使用 Spec Kit
新闻#
- Open Source Friday: Spec Kit Part 2（2026 年 10 月 16 日）——Manfred Riem 与 Nicole Haugen 讨论 Spec Kit 1.0 及扩展后的工具包。
- Living Specs in SpecKit（2026 年 10 月 15 日）——Alfredo Perez 探讨随着项目演进维护能力级规格。
- Spec Kit Customization Series（2026 年 10 月 8–10 日）——Jesse Liberty 讲解预设与扩展编写，包括测试与发布。
- From Spec-First to Enterprise-Ready: Extending GitHub Spec Kit（2026 年 10 月 7 日）——Apoorv Gupta 讲解通过预设、扩展、捆绑包、工作流和受治理目录进行企业定制。
- Open Source Friday with Spec Kit（2026 年 5 月 8 日）——Manfred Riem 的介绍与 SDD 演示。
星标历史#
感谢每一位帮助 Spec Kit 闪耀的人。
支持与贡献#
报告缺陷或请求功能 · 贡献指南 · 行为准则
Spec Kit 采用 MIT 许可证。