GitHub Spec Kit是一个实验性工具,帮助开发者通过规范驱动开发避免架构错误。它提供了一套轻量级工作流,结合VS Code和GitHub Copilot,让开发过程更加规范和可控,特别适合需要严格控制代码质量的项目。
智能速览
Spec Kit提供宪法、规范、计划、任务和实现的完整工作流
需要VS Code、GitHub Copilot扩展和Python 3.11+环境
使用uv工具安装specify-cli,比pip快10-100倍
新项目使用specify init命令初始化
在Copilot Chat中输入/可查看斜杠命令
现有项目也可无缝集成Spec Kit
精华内容
Spec Kit将开发规范内化为代码库原生工作流,通过Markdown文件和脚本引导,让规范不再停留在文档层面,而是成为开发过程的实际指引。
环境准备
使用前需要安装VS Code、GitHub Copilot及Chat扩展,并确保登录。Python环境需要3.11+版本,推荐使用uv作为包管理器。uv是Rust编写的高性能工具,安装速度比传统pip快10-100倍,集成了pip、poetry等多种工具的功能。通过uv tool install specify-cli --from git+https://github.com/github/spec-kit.git命令安装CLI工具。
新项目初始化
使用specify init my-new-project --ai copilot命令创建新项目。如果需要PowerShell脚本支持,可添加–script ps参数。初始化后必须用code my-new-project打开项目文件夹,否则Copilot Chat中不会显示斜杠命令。这一步很关键,很多开发者会误打开父目录导致功能失效。
斜杠命令使用
在VS Code的Copilot Chat输入框中输入/符号,会看到7个专用命令:/speckit.constitution定义不可协商项,/speckit.specify编写规范,/speckit.plan制定计划,/speckit.tasks生成任务,/speckit.implement进行实现,还有clarify和analyze用于澄清和分析。这些命令将规范驱动开发落到了实处。
现有项目集成
Spec Kit对现有项目同样友好。在项目根目录运行specify init . --ai copilot即可集成。如果提示覆盖文件,使用–force参数强制合并模板。这样既保持了原有代码的稳定性,又引入了规范驱动的工作流。项目会获得.github/prompts和.specify目录,包含模板和辅助脚本。