GitHub Spec Kit

wiki/ai/sources/github-spec-kit.md

分类：ai / sources · 更新：2026-07-05 17:46

GitHub Spec Kit

一句话结论

GitHub Spec Kit 是 GitHub 官方开源的 Spec-Driven Development 工具包，仓库地址为 https://github.com/github/spec-kit 。它把“先写清规格，再让 coding agent 执行”包装成可安装 CLI、项目模板和 agent slash commands：/speckit.constitution、/speckit.specify、/speckit.plan、/speckit.tasks、/speckit.implement 等。截至本次读取，GitHub 页面显示约 118,054 stars（页面 social count 约 118k），HEAD 为 bba473c223dc298fb76ecf8f87f86d5d2b8ed11c。

为什么对用户重要

用户的 Hermes / llm-wiki 工作流已经在实践“知识与规格先行”：先读 _index.md、查 log.md、搜索既有页、保存 raw，再写 synthesis。Spec Kit 的价值在于把这套思想推广到代码交付：规格不是聊天记录里的临时提示，而是版本化、可检查、可继续演进的项目资产。

这对 Agentic-Coding 尤其重要。coding agent 的能力越强，越需要稳定的上游约束来避免 vibe coding 式漂移。Spec Kit 把需求、技术计划、任务、收敛检查拆成不同命令，让 agent 的自由生成被规格、计划和任务序列约束。

机制 / 一阶原理

Spec Kit 的核心不是单个 prompt，而是一个分阶段 workflow：

Constitution：先建立项目原则与工程治理规则，写入 .specify/memory/constitution.md。
Specify：描述“要做什么/为什么”，刻意不先讨论技术栈。
Clarify / Checklist / Analyze：在实现前消除歧义、检查规格完整性和跨工件一致性。
Plan：再把需求映射到技术方案、架构选择和约束。
Tasks：把 plan 拆成可执行任务，必要时转成 GitHub issues。
Implement / Converge：执行任务后，用 converge 对照 spec/plan/tasks 找剩余缺口，直到收敛。

一阶原理是：当 AI 能够执行复杂实现时，工程 bottleneck 从“写代码”转向“定义正确问题、约束搜索空间、持续验证是否偏离意图”。Spec Kit 把自然语言规格提升为主 artifact，让代码成为规格和实现计划的表达。

与既有 wiki 概念的关系

对 Spec-driven-development：Spec Kit 是目前最值得跟踪的公开实现之一，它把 SDD 从方法论落到 CLI、模板、agent integration 和 commands。
对 Agentic-Coding：它提供了 coding agent 的上游约束层，减少“一句话需求 → 大量代码 → 人工返工”的循环。
对 Context-Engineering：.specify/、templates、slash commands 和 agent integrations 都是可版本化 context provider，不只是一次性 prompt。
对 Harness-Engineering：Spec Kit 偏 workflow harness：用阶段、模板、检查点和收敛命令控制 process drift；仍需测试、CI、权限边界和独立 review 承担 runtime / verification harness。

适用场景

场景	是否适合	说明
新项目 0→1	高	constitution/spec/plan/task 链路能快速建立项目边界。
有明显产品歧义的功能	高	`/speckit.clarify` 和 checklist 能在 coding 前暴露需求缺口。
老项目小修小补	中	可能显得重；适合中大型变更或需要沉淀长期规格的模块。
高风险生产变更	中高	能改善意图追踪，但仍必须叠加测试、review、灰度和回滚。
一次性脚本/探索	低	轻量 spike 更合适，除非探索结果会进入长期产品。

失败模式与边界

规格质量决定上限：如果 spec 只是把模糊需求换个文件保存，后续 plan/tasks 仍会偏。
流程可能过重：小任务不一定值得完整跑 constitution→converge。
agent integration 语义不同：README 声称支持 30+ coding agents，但各 agent 对 slash command、skills、权限和工具执行的支持不同，复制到 Hermes/Codex/Claude Code 前要验证。
不能替代真实验证：Spec Kit 控制“意图到计划”的链路，不自动证明代码正确；仍需测试、lint、CI、review 和可回滚部署。
GitHub API 读取受限：本次 GitHub REST API 因未认证触发 rate limit，stars 从网页 HTML 提取，README/仓库内容通过 raw GitHub 与 git clone 验证。

对 Hermes / llm-wiki 的可执行启发

对复杂编码任务，可以借鉴 Spec Kit，把“spec/plan/tasks/implement/converge”显式化到 Hermes plan 或项目 .hermes/ 中。
对 wiki 深度入库任务，converge 思路可转成结束前检查：raw 是否保存、source/concept 是否更新、index/log 是否更新、向量索引是否重建、链接是否断裂。
对外部 skills 生态评估，优先跟踪同时提供 CLI、模板、agent integration、catalog/extension 机制和验证命令的项目，而不是只有 prompt 文案的仓库。

深度判断

值得晋升为 source 页面。Spec Kit 是 GitHub 官方对 Spec-Driven Development 的工具化表达，并且与用户当前关注的 Context-Engineering、Harness-Engineering、Agentic-Coding、外部 skills 生态筛选高度相关。它补齐了既有 Spec-driven-development 页面中过于依赖 OpenSpec/Superpowers 的视角。

写入记录

2026-07-05 17:44 CST：新增 source 页面，基于 GitHub README、网页 HTML 和 shallow clone 提炼 Spec Kit 对 SDD、agentic coding workflow 与 Hermes/llm-wiki 的启发。