spec-kit
GitHub 出品的规范驱动开发工具包，让开发者先写产品需求（spec），再自动生成技术计划和可执行任务列表，最后交给 AI 编码代理（如 Claude、Copilot）逐项实现。核心亮点是把“先写规范再写代码”的流程固化为 CLI 命令和 agent 集成，减少 AI 生成的不确定性并提升代码质量。MIT 许可证。支持 30+ AI 编码代理插件和生态扩展。适合追求结构化 AI 协作的团队。
README
🌱 Spec Kit
更快地构建高质量软件。
一个开源工具包，让你专注于产品场景和可预测的结果，而不必从零开始逐行"vibe coding"。
目录
- 🤔 什么是规范驱动开发？
- ⚡ 快速开始
- 📽️ 视频概览
- 🧩 社区扩展
- 🎨 社区预设
- 🚶 社区演练
- 🛠️ 社区伙伴
- 🤖 支持的 AI 编码代理集成
- 🔧 Specify CLI 参考
- 🧩 定制你的 Spec Kit：扩展与预设
- 📚 核心理念
- 🌟 开发阶段
- 🎯 实验目标
- 🔧 前提条件
- 📖 了解更多
- 📋 详细流程
- 🔍 故障排除
- 💬 支持
- 🙏 致谢
- 📄 许可证
🤔 什么是规范驱动开发？
规范驱动开发 颠覆了 传统软件开发模式。几十年来，代码一直是主角——规范只是我们在编码"真正工作"开始之前搭建并丢弃的脚手架。规范驱动开发改变了这一点：规范变得可执行，直接生成可工作的实现，而不仅仅是指导实现。
⚡ 快速开始
1. 安装 Specify CLI
选择你偏好的安装方式：
重要： Spec Kit 唯一官方维护的包均发布自本 GitHub 仓库。PyPI 上同名的任何包 不 属于本项目，也不由 Spec Kit 维护者维护。请始终按照如下说明从 GitHub 直接安装。
选项 1：固定安装（推荐）
一次安装，随处使用。固定到特定发布标签以保持稳定性（查看 Releases 获取最新版本）：
[!NOTE] 下面的
uv tool install命令需要 uv——一个快速的 Python 包管理器。如果看到command not found: uv，请先安装 uv。替代方案pipx不需要 uv。
# 安装特定稳定版本（推荐——将 vX.Y.Z 替换为最新标签）
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z
# 或者从 main 分支安装最新版本（可能包含未发布的更改）
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
# 替代方案：使用 pipx（同样适用）
pipx install git+https://github.com/github/spec-kit.git@vX.Y.Z
pipx install git+https://github.com/github/spec-kit.git
然后验证已安装的正确版本：
specify version
并直接使用该工具：
# 创建新项目
specify init <PROJECT_NAME>
# 或者在已有项目中初始化
specify init . --integration copilot
# 或
specify init --here --integration copilot
# 检查已安装的工具
specify check
要升级 Specify，请参阅升级指南获取详细说明。快速升级：
uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git@vX.Y.Z
# pipx 用户：pipx install --force git+https://github.com/github/spec-kit.git@vX.Y.Z
选项 2：一次性使用
直接运行，无需安装：
# 创建新项目（固定到稳定版本——将 vX.Y.Z 替换为最新标签）
uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init <PROJECT_NAME>
# 或者在已有项目中初始化
uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init . --integration copilot
# 或
uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init --here --integration copilot
固定安装的好处：
- 工具保留在 PATH 中，随时可用
- 无需创建 shell 别名
- 更好的工具管理（
uv tool list、uv tool upgrade、uv tool uninstall） - 更干净的 shell 配置
选项 3：企业 / 离线安装
如果你的环境屏蔽了对 PyPI 或 GitHub 的访问，请参阅企业 / 离线安装指南，了解如何使用 pip download 在可联网设备上创建可移植的、特定于操作系统平台的 wheel 捆绑包的逐步说明。
2. 确立项目原则
在项目目录中启动你的编码代理。大多数代理将 spec-kit 暴露为 /speckit.* 斜杠命令；Codex CLI 在 skills 模式下使用 $speckit-* 代替。
使用 /speckit.constitution 命令创建项目的治理原则和开发指南，这些原则将指导后续所有开发。
/speckit.constitution 创建专注于代码质量、测试标准、用户体验一致性和性能要求的原则。
3. 创建规范
使用 /speckit.specify 命令描述你想要构建的内容。专注于 做什么和 为什么，而不是技术栈。
/speckit.specify 构建一个应用程序，帮助我整理照片到不同的相册中。相册按日期分组，可以通过在主页面拖拽来重新组织。相册永远不会嵌套在其他相册中。在每个相册内，照片以磁贴式界面预览显示。
4. 创建技术实现计划
使用 /speckit.plan 命令提供你的技术栈和架构选择。
/speckit.plan 该应用程序使用 Vite，库数量尽可能少。尽量使用原生的 HTML、CSS 和 JavaScript。图片不上传到任何地方，元数据存储在本地 SQLite 数据库中。
5. 分解为任务
使用 /speckit.tasks 从你的实现计划中创建可操作的任务列表。
/speckit.tasks
6. 执行实现
使用 /speckit.implement 执行所有任务，按照计划构建你的功能。
/speckit.implement
有关详细的分步说明，请参见我们的综合指南。
📽️ 视频概览
想看看 Spec Kit 的实际运行？观看我们的视频概览！
🧩 社区扩展
[!NOTE] 社区扩展由各自作者独立创建和维护。维护者仅验证目录条目是否完整且格式正确——他们 不审查、审计、认可或支持 扩展代码本身。社区扩展网站也是第三方资源。安装前请审查扩展源代码，并自行决定使用。
🔍 在社区扩展网站上浏览和搜索社区扩展。
以下社区贡献的扩展可在 catalog.community.json 中找到：
分类：
docs— 读取、验证或生成规范产物code— 审查、验证或修改源代码process— 编排跨阶段工作流integration— 与外部平台同步visibility— 报告项目健康度或进度
效果：
Read-only— 生成报告，不修改文件Read+Write— 修改文件、创建产物或更新规范
| 扩展名 | 用途 | 分类 | 效果 | URL |
|---|---|---|---|---|
| Agent Assign | 为 spec-kit 任务分配专门的 Claude Code 代理以进行定向执行 | process |
Read+Write | spec-kit-agent-assign |
| AI-Driven Engineering (AIDE) | 一个结构化的 7 步工作流，用于从零开始使用 AI 助手构建新项目——从愿景到实现 | process |
Read+Write | aide |
| API Evolve | 托管的 API 合约演进——破坏性变更检测、semver 强制、弃用编排以及跨 REST、GraphQL 和 gRPC 的生命周期门禁 | process |
Read+Write | spec-kit-api-evolve |
| Architect Impact Previewer | 预测提议更改对架构的影响、复杂度和风险，在实现之前进行 | visibility |
Read-only | spec-kit-architect-preview |
| Architecture Guard | 持续架构治理，适用于 AI 辅助开发。审查规范、计划和代码是否存在架构偏离，生成结构化的重构任务和演进建议 | process |
Read+Write | spec-kit-architecture-guard |
| Archive Extension | 将已合并的功能归档到主项目记忆中 | docs |
Read+Write | spec-kit-archive |
| Azure DevOps Integration | 使用 OAuth 认证将用户故事和任务同步到 Azure DevOps 工作项 | integration |
Read+Write | spec-kit-azure-devops |
| Blueprint | 在 AI 驱动的开发中保持代码素养：在 /speckit.implement 运行之前，从规范产物中审查每个任务的完整代码蓝图 |
docs |
Read+Write | spec-kit-blueprint |
| Branch Convention | 可配置的分支和文件夹命名约定，适用于 /specify，支持预设和自定义模式 |
process |
Read+Write | spec-kit-branch-convention |
| Brownfield Bootstrap | 为现有代码库引导 spec-kit——自动发现架构并逐步采用 SDD | process |
Read+Write | spec-kit-brownfield |
| BrownKit | 基于证据的能力发现、安全性和 QA 风险评估，适用于现有代码库 | process |
Read+Write | BrownKit |
| Bugfix Workflow | 结构化的缺陷修复工作流——捕获缺陷、追踪到规范产物、精准修复规范 | process |
Read+Write | spec-kit-bugfix |
| Canon | 添加基于 canon（基线驱动）的工作流：规范优先、代码优先、规范偏离。需要安装 Canon Core 预设。 | process |
Read+Write | spec-kit-canon |
| Catalog CI | 自动化验证 spec-kit 社区目录条目——结构、URL、差异和 lint 检查 | process |
Read-only | spec-kit-catalog-ci |
| CI Guard | 面向 CI/CD 的规范合规门禁——验证规范是否存在、检查偏离、在缺口处阻止合并 | process |
Read-only | spec-kit-ci-guard |
| Checkpoint Extension | 在实现过程中提交变更，避免最终只有一个非常大的提交 | code |
Read+Write | spec-kit-checkpoint |
| Cleanup Extension | 实现后质量门禁，审查更改、修复小问题（侦察兵规则）、为中型问题创建任务、为大型问题生成分析报告 | code |
Read+Write | spec-kit-cleanup |
| Conduct Extension | 通过子代理委派编排 spec-kit 阶段，以减少上下文污染 | process |
Read+Write | spec-kit-conduct-ext |
| Confluence Extension | 在 Confluence 中创建一个文档，汇总规范和规划文件 | integration |
Read+Write | spec-kit-confluence |
| Cost Tracker | 追踪 SDD 工作流中的真实 LLM 美元成本——按功能预算、按集成比较、财务就绪导出 | visibility |
Read+Write | spec-kit-cost |
| DocGuard — CDD Enforcement | 基于基线的开发强制。验证、评分并追踪项目文档，提供自动检查、AI 驱动工作流和 spec-kit 钩子。零 NPM 运行时依赖。 | docs |
Read+Write | spec-kit-docguard |
| Extensify | 创建和验证扩展及扩展目录 | process |
Read+Write | extensify |
| Fix Findings | 自动化分析-修复-再分析循环，解决规范发现项直至清零 | code |
Read+Write | spec-kit-fix-findings |
| FixIt Extension | 规范感知的缺陷修复——将缺陷映射到规范产物，提出计划，应用最小变更 | code |
Read+Write | spec-kit-fixit |
| Fleet Orchestrator | 编排完整的特性生命周期，在所有 SpecKit 阶段设置人工参与的门禁 | process |
Read+Write | spec-kit-fleet |
| GitHub Issues Integration 1 | 从 GitHub Issues 生成规范产物——导入 issue、同步更新、维护双向可追溯性 | integration |
Read+Write | spec-kit-github-issues |
| GitHub Issues Integration 2 | 从现有的 GitHub issue 创建并同步本地规范 | integration |
Read+Write | spec-kit-issue |
| Intelligent Agent Orchestrator | 跨目录代理发现和智能提示到命令的路由 | process |
Read+Write | spec-kit-orchestrator |
| Iterate | 使用两阶段定义-应用工作流迭代规范文档——在实现中途完善规范，然后直接返回构建 | docs |
Read+Write | spec-kit-iterate |
| Jira Integration | 从 spec-kit 规范和任务分解创建 Jira Epics、Stories 和 Issues，支持可配置层次结构和自定义字段 | integration |
Read+Write | spec-kit-jira |
| Learning Extension | 从实现生成教育指南，并通过辅导上下文增强澄清内容 | docs |
Read+Write | spec-kit-learn |
| MAQA — Multi-Agent & Quality Assurance | 协调器 → 功能 → QA 代理工作流，基于并行的 worktree 实现。语言无关。自动检测已安装的看板插件。可选的 CI 门禁。 | process |
Read+Write | spec-kit-maqa-ext |
| MAQA Azure DevOps Integration | 面向 MAQA 的 Azure DevOps Boards 集成——随着功能进展同步 User Story 和 Task 子项 | integration |
Read+Write | spec-kit-maqa-azure-devops |
| MAQA CI/CD Gate | 自动检测 GitHub Actions、CircleCI、GitLab CI 和 Bitbucket Pipelines。在管道变为绿色之前阻止 QA 交接。 | process |
Read+Write | spec-kit-maqa-ci |
| MAQA GitHub Projects Integration | 面向 MAQA 的 GitHub Projects v2 集成——随着功能进展同步草稿 issue 和状态列 | integration |
Read+Write | spec-kit-maqa-github-projects |
| MAQA Jira Integration | 面向 MAQA 的 Jira 集成——随着功能在看板上的进展同步 Stories 和 Subtasks | integration |
Read+Write | spec-kit-maqa-jira |
| MAQA Linear Integration | 面向 MAQA 的 Linear 集成——随着功能进展跨工作流状态同步 issues 和 sub-issues | integration |
Read+Write | spec-kit-maqa-linear |
| MAQA Trello Integration | 面向 MAQA 的 Trello 看板集成——从规范填充看板、移动卡片、实时勾选清单 | integration |
Read+Write | spec-kit-maqa-trello |
| MarkItDown Document Converter | 将文档（PDF、Word、PowerPoint、Excel 等）转换为 Markdown，作为规范参考材料 | docs |
Read+Write | spec-kit-markitdown |
| MDE | 最小模型驱动工程工作流，包含 setup、next 和 status 命令 | process |
Read+Write | spec-kit-mde |
| Memory Loader | 在生命周期命令之前加载 .specify/memory/ 文件，使 LLM 代理拥有项目治理上下文 | docs |
Read-only | spec-kit-memory-loader |
| Memory MD | 面向仓库原生 Markdown 记忆的 Spec Kit 扩展，捕获持久决策、缺陷和项目上下文 | docs |
Read+Write | spec-kit-memory-hub |
| MemoryLint | 代理记忆治理工具：自动审计并修复 AGENTS.md 与 constitution 之间的边界冲突 | process |
Read+Write | memorylint |
| Microsoft 365 Integration | 获取 Teams 消息、会议转录稿以及 SharePoint/OneDrive 文件，转为本地 Markdown 用于规范生成 | integration |
Read+Write | spec-kit-m365 |
| Multi-Model Review | 跨模型 Spec Kit 交接，用于规范编写、实现路由和审查 | process |
Read+Write | multi-model-review |
| .NET Framework to Modern .NET Migration | 编排端到端的 .NET Framework 到现代 .NET 迁移，跨越 7 个阶段，集成 SDD 生命周期 | process |
Read+Write | spec-kit-fx-to-net |
| Onboard | 为刚接触 spec-kit 项目的开发人员提供上下文引导和渐进式成长。解释规范、映射依赖、验证理解、指引下一步 | process |
Read+Write | spec-kit-onboard |
| Optimize | 审计并优化 AI 治理的上下文效率——token 预算、规则健康度、可解释性、压缩、一致性、回声检测 | process |
Read+Write | spec-kit-optimize |
| OWASP LLM Threat Model | 针对代理产物的 OWASP Top 10 for LLM Applications 2025 威胁分析 | code |
Read-only | spec-kit-threatmodel |
| Plan Review Gate | 要求在允许任务生成之前，将 spec.md 和 plan.md 通过 MR/PR 合并 | process |
Read-only | spec-kit-plan-review-gate |
| PR Bridge | 从规范产物自动生成拉取请求描述、检查清单和摘要 | process |
Read-only | spec-kit-pr-bridge- |
| Presetify | 创建和验证预设及预设目录 | process |
Read+Write | presetify |
| Product Forge | 从研究到发布的完整产品生命周期——投资组合、精简模式、单仓库、可选的 V-Model | process |
Read+Write | speckit-product-forge |
| Project Health Check | 诊断 Spec Kit 项目并报告健康问题，涵盖结构、代理、功能、脚本、扩展和 Git | visibility |
Read-only | spec-kit-doctor |
| Project Status | 显示当前 SDD 工作流进度——活动功能、产物状态、任务完成度、工作流阶段和扩展摘要 | visibility |
Read-only | spec-kit-status |
| QA Testing Extension | 系统化的 QA 测试，通过浏览器驱动或 CLI 驱动的验收标准验证（来自规范） | code |
Read-only | spec-kit-qa |
| Ralph Loop | 使用 AI 代理 CLI 的自主实现循环 | code |
Read+Write | spec-kit-ralph |
| Reconcile Extension | 通过精准更新功能产物来调和实现偏离 | docs |
Read+Write | spec-kit-reconcile |
| Red Team | 在 /speckit.plan 之前对规范进行对抗性审查——并行镜头代理发现 clarify/analyze 结构性无法捕捉的风险（提示注入、完整性缺口、跨规范偏离、静默失败）。输出结构化的发现报告；不自动编辑规范。 |
docs |
Read+Write | spec-kit-red-team |
| Repository Index | 为现有仓库生成索引，用于概览、架构和模块级别 | docs |
Read-only | spec-kit-repoindex |
| Retro Extension | Sprint 回顾分析，包含指标、规范准确性评估和改进建议 | process |
Read+Write | spec-kit-retro |
| Retrospective Extension | 实现后回顾，包含规范遵循度评分、偏离分析和人工门禁的规范更新 | docs |
Read+Write | spec-kit-retrospective |
| Review Extension | 实现后的全面代码审查，使用专门代理检查代码质量、注释、测试、错误处理、类型设计和简化 | code |
Read-only | spec-kit-review |
| Ripple | 检测实现后测试无法捕获的副作用——基于 delta 的分析，跨越 9 个与领域无关的分类 | code |
Read+Write | spec-kit-ripple |
| SDD Utilities | 恢复中断的工作流、验证项目健康度、验证规范到任务的可追溯性 | process |
Read+Write | speckit-utils |
| Security Review | 全项目安全设计审计，加上分阶段的分支/PR、计划、任务、跟进和应用审查 | code |
Read+Write | spec-kit-security-review |
| SFSpeckit | 企业 Salesforce SDLC，包含 18 个覆盖完整 SDD 生命周期的命令 | process |
Read+Write | spec-kit-sf |
| Ship Release Extension | 自动化发布流水线：预检、分支同步、变更日志生成、CI 验证和 PR 创建 | process |
Read+Write | spec-kit-ship |
| Spec Changelog | 从规范 Git 历史和需求差异自动生成变更日志和发布说明 | docs |
Read-only | spec-kit-changelog |
| Spec Critique Extension | 从产品策略和工程风险两个视角对规范和计划进行双镜头审查 | docs |
Read-only | spec-kit-critique |
| Spec Diagram | 自动生成 SDD 工作流状态、功能进度和任务依赖关系的 Mermaid 图 | visibility |
Read-only | spec-kit-diagram- |
| Spec Kit Schedule | 基于 CP-SAT 的最优多代理任务调度——DAG 前置依赖、幻觉感知上限、文件冲突避免、随机时长、重新规划、交互式 HTML 输出 | process |
Read+Write | spec-kit-schedule |
| Spec Orchestrator | 跨功能编排——跨并行规范跟踪状态、选择任务、检测冲突 | process |
Read-only | spec-kit-orchestrator |
| Spec Reference Loader | 读取功能规范中的 ## References 章节，仅将列出的文档加载到上下文中 | docs |
Read-only | spec-kit-spec-reference-loader |
| Spec Refine | 就地更新规范，将更改传播到计划和任务，并跨产物展示差异影响 | process |
Read+Write | spec-kit-refine |
| Spec Scope | 工作量估算和范围跟踪——估算工作、检测范围蔓延、按阶段预算时间 | process |
Read-only | spec-kit-scope- |
| Spec Sync | 检测并解决规范与实现之间的偏离。AI 辅助解决，需人工批准 | docs |
Read+Write | spec-kit-sync |
| Spec Validate | 对 spec-kit 产物进行理解验证、审查门禁和批准状态——阶段性测验、同行评审 SLA、以及 /speckit.implement 前的硬性门禁 |
process |
Read+Write | spec-kit-spec-validate |
| Spec2Cloud | 面向 Azure 部署优化的规范驱动工作流 | process |
Read+Write | spec2cloud |
| SpecTest | 从规范标准自动生成测试脚手架、映射覆盖率、发现未测试的需求 | code |
Read+Write | spec-kit-spectest |
| Squad Bridge | 从你的 Speckit 规范和任务引导并同步一个 Squad 代理团队 | process |
Read+Write | spec-kit-squad |
| Staff Review Extension | 员工工程师级别的代码审查，验证实现是否符合规范，检查安全性、性能和测试覆盖率 | code |
Read-only | spec-kit-staff-review |
| Status Report | 项目状态、功能进度和下一步行动建议，面向规范驱动工作流 | visibility |
Read-only | Open-Agent-Tools/spec-kit-status |
| Superpowers Bridge | 在 spec-kit SDD 工作流中编排 obra/superpowers 技能，覆盖完整生命周期（澄清、TDD、审查、验证、批评、调试、分支完成） | process |
Read+Write | superpowers-bridge |
| Superpowers Bridge (WangX0111) | 将 spec-kit 与 obra/superpowers（头脑风暴、TDD、子代理、代码审查）桥接到一个统一的、可恢复的工作流中，具有优雅降级和会话进度追踪功能 | process |
Read+Write | superspec |
| TinySpec | 适用于小任务的轻量级单文件工作流——跳过繁琐的多步 SDD 流程 | process |
Read+Write | spec-kit-tinyspec |
| Token Consumption Analyzer |