用途:从用户输入的自然语言功能描述出发,创建或更新功能规格说明,将需求整理为面向业务方的 WHAT/WHY 文档,避免写出技术实现细节。
主要能力:生成 2-4 词的功能短名(动作-名词形式,保留 OAuth2、API、JWT 等术语);在 specs/ 下创建功能目录与 spec.md;按模板与项目宪法填充用户场景与测试、功能需求、成功标准、关键实体等章节;生成 requirements.md 质量清单并反复校验,最多迭代 3 次;对关键歧义最多保留 3 个 [NEEDS CLARIFICATION] 标记并以选项表向用户提问;用 .specify/feature.json 记录解析后的功能目录路径,供 /speckit-plan、/speckit-tasks 等下游命令使用。
使用方式:在消息中以 /speckit-specify 后接功能描述触发;描述为空时报错。目录前缀按 .specify/init-options.json 的 feature_numbering 决定:timestamp 用 YYYYMMDD-HHMMSS,sequential 或缺失用三位序号 NNN;也可显式传入 SPECIFY_FEATURE_DIRECTORY。命令会执行 mkdir -p SPECIFY_FEATURE_DIRECTORY 并复制解析出的 spec-template 到该目录的 spec.md。扩展钩子配置在 .specify/extensions.yml 的 hooks.before_specify 与 hooks.after_specify 下,条件表达式交由 HookExecutor 评估,命令名中的点替换为连字符(如 speckit.git.commit → /speckit-git-commit)。
适用场景:需求早期把口头/自然语言的功能想法沉淀为可评审、可测试、与实现无关的规格,为后续 clarify、plan、tasks 阶段做准备。
限制:每次调用只创建一个功能;规格目录名与 git 分支名相互独立;规格目录与文件始终由本命令创建而非钩子;不生成嵌入规格内的清单;具体性能、收费、平台支持等信息资料未提供。