spec-kit

spec-kit — 通过 specify 进行规格驱动开发

GitHub 的 spec-kit 颠覆了常见的流程： 规格说明变得可执行，并直接驱动实现。此技能是上游 specify CLI 的路由优先封装——它会安装该工具、为所选 AI Agent 初始化项目，并引导用户完成由五个步骤组成的 SDD 命令流程。

何时使用此技能

• 用户要求安装 spec-kit、specify-cli 或“GitHub spec kit”
• 用户想以规格驱动开发工作流启动项目
• 用户输入或询问 /speckit.constitution、/speckit.specify、 /speckit.plan、/speckit.tasks、/speckit.implement、/speckit.clarify、 /speckit.analyze 或 /speckit.checklist
• 用户想在 Claude Code、Copilot、Gemini、Cursor、Codex、opencode、Qwen、Kiro 或其他受支持的 Agent 之间共享可执行规格
• 用户想查找社区 spec-kit 扩展或预设 （specify extension search、specify preset search）

何时不使用此技能

• 用户想要一个与供应商无关、以数据包优先的规划路由器，用于分类下一个 BMAD 工件 → 使用 bmad
• 用户需要一个具有不可变种子且能感知漂移的执行循环，并且不依赖 GitHub spec-kit → 使用 ooo
• 用户想要对现有计划或差异进行可视化审查／批准→ 使用 plannotator
• 用户想在任何规格说明出现之前进行规划前的概念构思（问题、受众、定位）→ 使用 bmad-idea

前提条件

要求	说明
Linux / macOS / Windows	Windows 上可使用原生环境或 WSL
Python 3.11+	specify-cli 的必需项
uv（推荐）或 pipx	工具安装管理器
git	仓库及插件市场操作
一个受支持的 AI Agent	Claude Code、Copilot、Gemini、Codex 等

说明

步骤 1 — 安装 specify-cli

# Recommended: uv tool install (pins via Git ref)
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

# Pinned to a tag (reproducibility):
uv tool install specify-cli --from git+https://github.com/github/[email protected]

# Alternative: pipx
pipx install git+https://github.com/github/spec-kit.git

# Verify
specify --version
specify integration list

步骤 2 — 选择目标 AI Agent

specify integration list 会列出所有受支持的 Agent。常见选项：

Agent	--integration 的值
Claude Code	claude
GitHub Copilot	copilot
Google Gemini CLI	gemini
OpenAI Codex CLI	codex
Cursor CLI	cursor
opencode	opencode
Qwen CLI	qwen
Kiro CLI	kiro

步骤 3 — 初始化项目

# Create a new project directory and bootstrap it
specify init my-project --integration claude

# Bootstrap in the current directory
specify init . --integration copilot

# Force-overwrite into the current directory
specify init --here --force --integration gemini

此操作会写入 .specify/、Agent 专用的命令文件和章程模板。

步骤 4 — 执行 SDD 命令流程

在所选 Agent 中运行这些斜杠命令（Claude Code、Copilot、Gemini 等）。Agent 会读取 specify init 写入的文件。

命令	用途
/speckit.constitution	确立项目原则和不可妥协的要求
/speckit.specify	记录需求和用户故事
/speckit.plan	制定技术实现策略
/speckit.tasks	将计划拆解为可执行任务
/speckit.implement	逐项执行计划中的任务

可选的优化步骤：

• /speckit.clarify — 通过访谈消除规格说明中的歧义
• /speckit.analyze — 检查章程、规格说明和计划之间的一致性
• /speckit.checklist — 生成用于评审关卡的质量检查清单

步骤 5 — 扩展和预设（社区）

specify extension search
specify extension add <extension-name>

specify preset search
specify preset add <preset-name>

浏览社区资源：https://github.github.io/spec-kit/community/。

步骤 6 — 与 jeo-skills 并行进行插件式安装

此技能文件夹可通过标准 jeo-skills 流程以插件形式安装，以便将封装、参考资料和安装脚本部署到磁盘，供任何受支持的 Agent 运行时使用：

# Project install (writes into .agents/skills/spec-kit/)
npx skills add https://github.com/akillness/jeo-skills --skill spec-kit

# Global install for every detected agent
npx skills add -g https://github.com/akillness/jeo-skills --skill spec-kit

# Target specific agents
npx skills add -g https://github.com/akillness/jeo-skills --skill spec-kit -a claude-code -a codex -y

此技能还附带 scripts/install.sh，这是一个一键安装程序，可检测 uv / pipx 并执行步骤 1。

输出格式

当用户向 spec-kit 寻求帮助时，返回一份简洁的概要：

# spec-kit Routing Brief

## Scope
- Target agent: claude | copilot | gemini | codex | cursor | opencode | ...
- Project state: new | existing-init | mid-pipeline | extension-only
- Pipeline stage: constitution | specify | plan | tasks | implement | clarify | analyze | checklist

## Recommended next move
- install-specify | specify-init | run-/speckit.<command> | add-extension

## Why
- 2-3 bullets grounded in the user's packet

## Route-outs
- `ooo` for vendor-neutral spec-first loops
- `bmad` for packet-first BMAD/BMM artifact selection
- `plannotator` for approval/review of an existing plan

最佳实践

1. 固定 Git 引用（@v0.0.10 或提交 SHA），确保可复现性——main 会不断变动。
2. 每个仓库只集成一种方案，除非用户明确需要多 Agent 保持一致；切换 --integration 会重写命令文件。
3. 将 /speckit.constitution 视为关键依据——下游的 /speckit.plan 和 /speckit.tasks 都会遵循它，因此原则发生变化时，应先更新它。
4. 在 /speckit.plan 前使用 /speckit.clarify，处理规范中的歧义，而不是让计划掩盖尚未解决的问题。
5. 在对 2 级及以上工作执行 /speckit.implement 前，将产物交给 plannotator 明确审查。
6. 如果用户实际需要的是供应商中立、带偏差跟踪的规范优先流程，而不是 GitHub 的流水线，则转交给 ooo。

参考资料

• 上游仓库：https://github.com/github/spec-kit
• 文档站点：https://github.github.io/spec-kit/
• 社区预设和扩展：https://github.github.io/spec-kit/community/
• 安装脚本：scripts/install.sh
• 命令参考：references/commands.md
• 相关技能：../ooo/SKILL.md、../bmad/SKILL.md、 ../plannotator/SKILL.md、../bmad-idea/SKILL.md
• 许可证：MIT（参见上游 LICENSE）