SuperAPI AI 工具集

spec-driven

编程与开发

查看项目

更新于 10-16 04:29

技能介绍

用途:该技能用于在编写代码之前先生成规格说明,确保需求对齐、可追溯并防止回归。适用于实现新功能、修复 Bug、重构代码、创建规格、规划实现,以及用户提到 spec、specification、structured development、SDLC 或“先设计后编码”等场景。

主要能力:按意图路由到 feature、bugfix、refactor、implement、evolve 子技能;意图不明确时会询问工作类型。核心流程分为 CLARIFY(澄清需求)、SPECIFY(用 EARS 格式生成规格与验收标准)、DESIGN(复杂功能的技术设计,可选)、IMPLEMENT(逐任务实现)、VALIDATE(验证清单与行为保持)五个阶段,每个阶段之间设有强制审批门禁,未获用户明确批准不得继续。规格文件统一放在项目根目录 specs/ 下,按 features、bugfixes、refactors 分类组织。支持会话恢复协议,可根据已有规格文件的 frontmatter status 字段判断当前阶段;已完成规格还可做 Spec-Drift 检测,对比规格与代码库的文件、API 差异。

使用方式:用户可通过 /spec feature {name}、/spec bugfix {description}、/spec refactor {area}、/spec implement、/spec evolve {feature}、/spec status、/spec checklist 等命令调用具体阶段。需求使用 EARS 语法编写(WHEN … THE SYSTEM SHALL … SO THAT …),并附验收标准。

限制:审批门禁不可跳过,即使用户要求一次产出多个阶段,也只能输出当前阶段并停下等待批准;文档未提供具体安装命令、收费、价格或平台信息。