SuperAPI AI 工具集

speckit-specify

编程与开发

查看项目

更新于 10-16 08:07

技能介绍

用途:speckit-specify 是一个斜杠命令技能,根据用户键入的自然语言功能描述,生成或更新功能规格(spec)。它只关注用户“需要什么、为什么需要”,避免涉及具体实现方式,适合在规划之前先厘清需求。

主要能力:从功能描述中提取关键概念(角色、动作、数据、约束),生成 2-4 个词的短名称;创建功能规格目录(默认位于 specs/ 下),将 .specify/templates/spec-template.md 复制为 spec.md 作为起点;填充用户场景与测试、功能需求、成功标准、关键实体等章节;成功标准要求可度量且与技术无关;将解析后的目录路径写入 .specify/feature.json,便于 /speckit-plan、/speckit-tasks 等下游命令定位。

使用方式:以 /speckit-specify 后跟功能描述触发,描述内容作为待处理输入。若根目录存在 .specify/extensions.yml,会先检查 hooks.before_specify 中的扩展钩子,并在完成后检查 hooks.after_specify;钩子命令名中的点号会转换为连字符(如 speckit.git.commit 对应 /speckit-git-commit)。目录前缀可依 .specify/init-options.json 的 branch_numbering 采用时间戳 YYYYMMDD-HHMMSS 或顺序号 NNN。也可通过用户提供的 SPECIFY_FEATURE_DIRECTORY 指定目录。每次调用只创建一个功能。

质量校验与澄清:生成初稿后会按质量清单校验(如无实现细节、需求可测试、成功标准可度量等),失败则更新规格,最多迭代 3 次。若存在 [NEEDS CLARIFICATION] 标记,最多保留 3 个最关键问题,以 A/B/C/自定义选项的形式集中向用户提问,用户答复后再替换标记并重新校验。

适用场景与限制:适用于开发前期的需求梳理与规格撰写,面向业务相关方而非开发者。它是规格命令,不负责实现;分支创建由 before_specify 钩子处理,规格目录与文件始终由本命令创建。资料未提供其安装方式、平台、收费与价格等信息。