SuperAPI AI 工具集

spec-kit

Spec Kit 是 GitHub 开源的一套工具包,用于支持规格驱动开发(Spec-Driven Development,SDD)。它提供 specify CLI 和一系列斜杠命令(如 /speckit.specify、/speckit.plan、/speckit.implement 等),可与 30 多种 AI 编程智能体集成,将规格说明转化为可执行的实施计划。该工具包还包含缺陷修复和想法评估两个可选扩展流程,帮助开发者以结构化方式使用 AI 编程智能体。

访问官网

工具介绍

Spec Kit 是 GitHub 推出的开源工具包,旨在帮助开发者以规格驱动开发(Spec-Driven Development,SDD)或其他自定义流程来使用 AI 编程智能体。它为 AI 编程智能体提供结构化流程、可复用模板和文档化产出。

用途

Spec Kit 的核心用途是让 AI 编程智能体按照明确的规格说明来工作,而不是直接生成代码。它适用于三种独立入口:规格驱动开发(SDD)、缺陷修复和想法评估。这三个入口并非强制阶段,SDD 内置于核心,缺陷修复和评估是可选扩展,需要时安装。

主要能力

  • 规格驱动开发(SDD):将需求转化为规格说明、技术计划和可执行任务,然后指导实施。每个项目执行一次 constitution,每个功能按 specify → plan → tasks → implement → converge 流程进行。可重复 implement → converge 直到收敛报告显示 Converged。还可添加澄清、检查清单和一致性分析作为额外质量关卡。
  • 缺陷修复:将诊断、修复和验证分开,让智能体修复已评估的原因并检查原始症状。无需先执行 SDD 功能流程。通过 CLI 安装可选扩展后,在智能体聊天中依次调用 assess → fix → test 技能。报告存放在 .specify/bugs/login-crash/ 目录下,最终判定为 verified、partial 或 failed。缺少验证不算成功修复。
  • 想法评估:在投入想法之前收集证据,无论是否最终成为软件。该独立流程甚至可在没有源代码的项目中运行。依次调用 intake → research → define → shape → decide 技能,产出物存放在 .specify/assessments/offline-mode/ 目录下,最终给出 go / needs-clarification / kill 决策。可通过直接完善现有 Markdown 产出物或借助智能体来解决未知问题,而不是重新生成整个阶段。go 决策可交给 /speckit-specify 继续构建;以文档化理由停止也是有用结果。
  • 自定义或自带流程:扩展增加能力,预设调整现有行为,工作流自动化步骤,捆绑包打包基于角色的设置。可使用项目本地覆盖进行一次性模板修改。

使用方式

需要 Python 3.11+、uv 以及受支持的 AI 编程智能体,支持 Linux、macOS 或 Windows。仅进行 CLI 设置时,在终端运行安装 Spec Kit 并创建项目。示例使用 GitHub Copilot 的默认技能模式,将 copilot 替换为其他集成键即可使用其他受支持的智能体。已有代码可参考现有项目指南。固定版本、其他安装器、CI 或故障排除请参阅安装文档。更新现有安装请参阅升级文档。

安装后,在项目目录中启动编程智能体,选择上述流程之一。在智能体聊天中逐个调用每个 /speckit-* 技能,并在继续前审查结果。这些是智能体技能,不是终端命令。其他智能体和模式可能使用不同的调用语法。

适用场景

Spec Kit 适用于希望以结构化、可审查的方式使用 AI 编程智能体的开发者,包括:从零开始构建新功能、修复已有代码中的缺陷、评估新想法是否值得投入,以及需要将规格说明转化为可执行计划的团队。

限制

需要 Python 3.11+、uv 和受支持的 AI 编程智能体。不同智能体和模式的技能调用语法可能不同。缺陷修复和想法评估需要额外安装扩展。缺少验证的修复不被视为成功。具体支持的智能体列表、安装细节和故障排除信息请参阅官方文档。