用途:speckit-specify 源自 GitHub Spec Kit 官方提示词模板(上游 https://github.com/github/spec-kit,MIT License, Copyright GitHub, Inc.),用于把用户用自然语言给出的功能描述转化为结构化功能规格说明,是 Spec Kit 工作流中规格阶段的一步。
主要能力:从描述中提取参与者、动作、数据与约束;生成 2-4 词的功能短名(如 user-auth、oauth2-api-integration);在 specs/ 下创建功能目录并复制解析后的 spec-template 为 spec.md;写入 .specify/feature.json 记录 feature_directory;生成 checklists/requirements.md 质量检查清单并迭代校验;对关键歧义最多保留 3 个 [NEEDS CLARIFICATION] 标记并以选项表向用户提问;执行 .specify/extensions.yml 中 before_specify 与 after_specify 钩子。
使用方式:在对话中给出功能描述(对应原文 $ARGUMENTS),技能据此执行。目录默认位于 specs/,可用 SPECIFY_FEATURE_DIRECTORY 显式指定;编号读取 .specify/init-options.json 的 feature_numbering(timestamp 或 sequential)。创建目录使用 mkdir -p SPECIFY_FEATURE_DIRECTORY。跨命令引用如 speckit.plan 对应同名 speckit-* 技能。
适用场景:需要按 Spec Kit 流程先写规格、再澄清与规划的功能开发前期工作。
限制:每次调用只创建一个功能;规格目录名与 git 分支名相互独立;规格目录与文件始终由本命令创建而非钩子;规格聚焦 WHAT 与 WHY,不写实现细节;无法解析 extensions.yml 时需告知用户而非静默跳过;其余细节以官方模板为准。