SuperAPI AI 工具集

speckit-specify

通用与其它

查看项目

更新于 10-15 20:34

技能介绍

用途:把自然语言的功能描述转成结构化的功能规格说明。

主要能力:解析功能描述并提取参与者、动作、数据与约束;生成 2-4 词短名称;在 specs/ 下创建功能目录(前缀可为顺序号 NNN 或时间戳 YYYYMMDD-HHMMSS,取决于 .specify/init-options.json 中的 feature_numbering);复制解析到的规格模板为 spec.md;填写用户场景与测试、功能需求、成功标准、关键实体;生成规格质量检查清单并迭代校验;把待澄清问题以最多 3 个问题的形式呈现给用户。

使用方式:通过命令调用,功能描述作为 /speckit-specify 后的参数;在项目根存在 .specify/extensions.yml 时,会先检查并执行 hooks.before_specify 下的钩子(命令名中的点替换为连字符,如 speckit.git.commit 对应 /speckit-git-commit),完成后执行 hooks.after_specify 下的强制钩子;结果目录路径写入 .specify/feature.json 的 feature_directory 字段,供后续 /speckit-plan、/speckit-tasks 等使用。可选使用 SPECIFY_FEATURE_DIRECTORY 显式指定目录。

适用场景:在规划与任务拆解之前,需要将功能想法整理为可评审、可验证的产品规格时使用。

限制:每次调用只创建一个功能;若描述为空则报错;无法确定用户流程时无法生成规格;最多保留 3 个 [NEEDS CLARIFICATION] 标记;规格应聚焦“做什么”和“为什么”,避免实现细节(技术栈、API、代码结构);hooks 的 condition 表达式不由本命令求值。资料未提供安装命令、收费与价格信息。