SDDRESEARCH MAP

Tool profile · 04 / 05

GitHub Spec Kit

GitHub 提供的 specification-driven development toolkit。它通过 specify CLI、模板、脚本和 agentic commands，把意图推进为规格、计划、任务和实现。

初步记录官方项目 · github/spec-kit核对日期 · 2026-08-21
主要形态
CLI + 模板 + Agent commands
独立 CLI
specify
主要关注
规格阶段与项目脚手架

01 · Why included

为什么纳入 SDD 相关研究

官方事实

Spec Kit 明确以 specification-driven development 为核心，默认主路径为 Spec → Plan → Tasks → Implement，是研究 SDD 阶段化产物和 Agent 集成的直接样本。

02 · Problem

解决什么问题

官方事实

让意图先于代码

每个阶段产生 Markdown artifact，并把上一步的结构化上下文交给下一步。

初步观察

统一不同 Agent 的入口

CLI 负责项目脚手架和 integration，宿主中的 /speckit.* 或 skill 负责推进 agentic SDD。

03 · Core assets

核心资产

constitution

项目原则和跨功能决策的高层约束。

spec → plan → tasks

从需求行为到技术计划和可执行任务的阶段产物。

.specify/

模板、脚本和集成配置等项目级工作流基础设施。

04 · Workflow

核心 Agentic SDD 路径

  1. Constitution · 按需
    建立或更新项目原则。
  2. Specify
    描述要构建什么，并形成可审阅规格。
  3. Clarify / checklist · 质量门禁
    识别歧义并建立需求质量检查。
  4. Plan → Tasks
    生成技术计划，再拆分为可执行任务。
  5. Analyze → Implement → Converge
    核查跨产物一致性、实施，并评估代码与 artifacts 的剩余差距。

05 · Installation

安装与运行形态

官方安装入口
uv tool install specify-cli
specify init my-project --integration codex

官方也支持从 GitHub release tag、PyPI、pipx 或一次性 uvx 运行。初始化时选择 coding agent integration 和脚本类型。

06 · CLI & host

CLI 与宿主依赖

结论

Spec Kit 使用独立的 specify CLI

CLI 管理项目初始化、检查、集成和工作流基础设施；宿主 Agent 执行 /speckit.* 或对应 skill 流程。

宿主 coding agent需要，用来执行 agentic commands 或 skills。
specify CLI需要，用于初始化和管理 Spec Kit 项目。
运行前置官方当前要求 Python 3.11+，推荐使用 uv；Git 按扩展需要。

07 · Early strengths

初步优势

  • 主路径和阶段产物命名清晰，适合建立统一的 SDD 入门模型。
  • 提供 clarify、checklist、analyze 和 converge 等跨 artifact 质量门禁。
  • CLI、integrations、extensions、presets 和 workflows 形成可扩展工具体系。

08 · Limits

限制与风险

  • 阶段和 artifacts 较多，小变更可能需要裁剪流程。
  • 当前每个项目一次只启用一个 integration，切换宿主的体验需要实测。
  • CLI、模板、扩展和项目产物的升级边界需要持续观察。

09 · Scenarios

可能适用的场景

当团队希望以明确、可教学的 Spec → Plan → Tasks → Implement 路径推进工作，并需要质量检查、宿主集成和可扩展模板时，Spec Kit 可能有价值。旧项目接入和短小修复的实际成本仍需单独验证。

10 · Relations

与其他工具的初步关系

初步观察

Spec Kit 和 OpenSpec 都把规格写入仓库，但前者更显式地组织阶段化交付链，后者突出 current specs 与 change deltas 的长期演进。BMad 同样分阶段，但使用更多角色与模块；需要通过同题实验比较产物重叠。

11 · Next research

后续研究问题

  • 同一个棕地需求需要创建多少项目级和 feature 级 artifacts？
  • clarify、checklist、analyze 和 converge 分别能发现哪些真实问题？
  • 切换 Codex、Claude Code 等 integration 时已有产物如何保留？
  • feature 完成后，spec 与代码长期同步由什么机制承担？

12 · Official sources

官方来源