SuperAPI AI 工具集

speckit-specify

编程与开发

查看项目

更新于 10-16 03:15

技能介绍

用途:当用户希望根据一段自然语言描述创建或更新功能规格(feature spec)时使用。输入为用户的功能描述,以及包含 .specify/ 脚本与模板的仓库上下文;若描述缺失或不清晰,应先提出针对性问题。

主要能力:从描述中提取关键词,生成 2-4 词的短名(如 user-auth、oauth2-api-integration),检查远程分支、本地分支与 specs 目录以确定下一个可用编号,然后运行 .specify/scripts/bash/create-new-feature.sh 创建并检出分支、初始化规格文件。随后按 .specify/templates/spec-template.md 的结构写入规格,包含用户场景与测试、功能需求、成功标准、关键实体等,并生成 FEATURE_DIR/checklists/requirements.md 质量检查清单。

使用方式:脚本示例:.specify/scripts/bash/create-new-feature.sh --json --number 5 --short-name "user-auth" "Add user authentication";PowerShell 示例:.specify/scripts/bash/create-new-feature.sh -Json -Number 5 -ShortName "user-auth" "Add user authentication"。每个功能只运行该脚本一次,JSON 输出包含 BRANCH_NAME 与 SPEC_FILE。

限制:规格聚焦 WHAT 与 WHY,避免实现细节(技术栈、API、代码结构);[NEEDS CLARIFICATION] 标记最多 3 个,按范围、安全隐私、用户体验、技术细节排序;成功标准须可度量且与技术无关;验证最多迭代 3 次。输出为 specs/<feature>/spec.md 与 specs/<feature>/checklists/requirements.md,后续可衔接 speckit-clarify 与 speckit-plan。