[开源工具] Spec Kit：面向 AI 编程的规范驱动开发工具包

GitHub 开源的规范驱动开发（SDD）工具包，通过在编码前将需求、架构与原则沉淀为结构化规范文件，引导 AI Agent 按序执行设计、任务拆分、代码实现与对账收敛。

本条目基于官方仓库 github/spec-kit v1.0.1 进行梳理与收录。

一、项目定位与设计概述

在利用自然语言辅助软件开发时，直接向大语言模型提交笼统的功能描述并期望其一步到位生成完整实现，容易引发代码失控。在多文件或复杂项目中，模型容易出现引入冗余外部依赖、破坏既有模块边界、遗漏异常分支以及在长会话中丢失上下文等问题。

Spec Kit 是 GitHub 开源的规范驱动开发（Spec-Driven Development, SDD）工程脚手架。项目推行“规范即可执行”（Specifications Become Executable）的协作模式。在编写代码之前，先通过结构化模板引导 Agent 建立项目宪章、固化功能需求边界并拆解技术架构方案，将人类意图转化为可逐步执行与验证的原子任务清单。

通过命令行工具 specify-cli，项目在初始化阶段即可向各类 AI 编程环境注入标准化的斜杠指令（Slash Commands）或 Agent 技能（Skills），使模型在清晰的工程边界内执行代码生成与自洽收敛。

二、命令交互与工作流实践

1. 环境准备与项目初始化

specify-cli 基于 Python 3.11+ 构建，推荐使用 uv 进行全局工具链管理：

# 通过 uv 安装 specify-cli
uv tool install specify-cli

# 交互式初始化新项目并指定 Agent 集成
specify init <project-name> --integration <agent>

# 在现有项目目录中静默强制初始化(--non-interactive参数为无交互初始化，移除则启用交互面板 --integration <agent>参数为显式指定agent，移除则在交互面板手动指定)
specify init --here --force --non-interactive --integration <agent>

2. 六阶段标准交付流水线

完成初始化后，在 Agent 会话窗口中可按序调用以下核心指令推进完整功能开发：

/speckit.constitution（立项原则）：确立项目全局架构底线、质量标准与依赖约束。单个项目通常在开局时执行一次；
/speckit.specify（需求定义）：以自然语言描述用户故事与验收指标，只聚焦业务目标与价值，避免在此阶段夹杂框架语法或具体实现；
/speckit.plan（技术方案）：结合代码库现状进行技术选型、模块拆分与文件目录规划，明确实现路径；
/speckit.tasks（任务拆解）：将架构方案细化为粒度在数分钟内可完成的原子任务清单；
/speckit.implement（代码实现）：驱动 Agent 逐项读取任务清单并编写对应代码；
/speckit.converge（对账收敛）：自动比对代码产物与原始规范文档，找出遗漏的边界分支并追加补全任务，循环执行直到状态报告为收敛（Converged）。

3. 过程质量控制辅助指令

/speckit.clarify：在方案设计（Plan）前触发，引导 Agent 主动针对模糊需求进行追问与死角排查；
/speckit.analyze：在编码动工（Implement）前触发，静态检查需求、技术方案与任务清单三者之间的一致性与覆盖完整度；
/speckit.checklist：将需求规范转化为逐条核对清单，充当自然语言层面的单元测试。

4. 专项工程流转扩展

Spec Kit 内置了开箱即用的特定场景扩展：

缺陷修复扩展（bug 扩展）：通过 specify extension add bug 启用，提供 assess（根因评估） $\to$ fix（针对性修复） $\to$ test（测试验证）的证据链排错流程；
需求评估扩展（assess 扩展）：通过 specify extension add assess 启用，提供 intake $\to$ research $\to$ define $\to$ shape $\to$ decide 五步评估流程，在立项前形成完整的可行性决策记录。

三、核心架构与功能特性

1. 四层模板优先级解析机制

Spec Kit 采用自顶向下的运行时模板解析堆栈：

项目本地覆盖（.specify/templates/overrides/）：单项目专属定制，优先级最高；
预设模板（.specify/presets/templates/）：通过 Preset 导入的组织级规范；
扩展模板（.specify/extensions/templates/）：通过 Extension 引入的扩展功能模版；
内置默认模板（.specify/templates/）：核心默认规范。

该解析机制支持开发者随时进行本地微调，并在移除自定义项后平滑回退至内置默认配置。

2. 双轮驱动的可扩展设计（Extensions 与 Presets）

Extensions（能力扩展）：用于扩展功能边界，引入新指令与新工作流（例如集成外部任务系统、代码安全审计或专项排错流程）；
Presets（规则定制）：用于重塑现有模板内容与规范约束（例如适配合规审计格式、领域驱动设计 DDD 规范或多语言本地化）。

3. 角色预设套件（Bundles）

Bundle 将一组经过验证的 Extensions、Presets 与工作流组合打包为独立分发单元。针对产品经理、安全研究员、开发者等不同工程角色，开发者可通过 specify bundle install <bundle-id> 实现一键装配。

四、生态集成与专属特性

1. 30+ 款 AI 编程宿主深度集成

Spec Kit 深度适配了主流 CLI 工具（如 GitHub Copilot CLI、Claude Code 等）与现代 AI 编辑器（如 Cursor 等）在内的 30 多款环境。除了常规的 Prompt 指令文件外，还支持通过 --integration-options="--skills" 生成原生 Agent Skills。

2. 工具链自管理能力（Self-Management）

CLI 内置了平滑版本检查与就地升级能力：

# 检查是否有新版本可用（只读操作，不变更本地环境）
specify self check

# 预览升级执行逻辑
specify self upgrade --dry-run

# 原地更新至最新稳定版
specify self upgrade

# 锁定升级至指定 Release 标签
specify self upgrade --tag v1.0.1

一、 项目定位与设计概述

二、 命令交互与工作流实践