中文功能规范创建工具,用于将自然语言功能描述转换为结构化的功能规范文档。支持自动生成分支名称、创建Git分支、初始化规范文件和质量验证。触发词包括:"speckit规范"、"功能规范"、"创建规范"、"功能描述转换"、"speckit-specify"。当用户需要将功能想法转换为结构化规范时使用此技能。
View on GitHubskills/speckit-specify-zh/SKILL.md
February 1, 2026
Select agents to install to:
npx add-skill https://github.com/forztf/open-skilled-sdd/blob/main/skills/speckit-specify-zh/SKILL.md -a claude-code --skill speckit-specify-zhInstallation paths:
.claude/skills/speckit-specify-zh/## 用户输入
```text
$ARGUMENTS
```
在继续之前,您**必须**考虑用户输入(如果非空)。
## 大纲
触发消息中用户在触发词后键入的文本**就是**功能描述。假设在此对话中始终可以使用该功能描述,即 `$ARGUMENTS`。除非用户提供了一个空命令,否则不要要求用户重复。
根据该功能描述,请执行以下操作:
1. 将 `assets/specify/` 所有文件(包括子目录)按原目录结构复制到仓库根目录下的`.specify` 目录,跳过已有文件,**不能覆盖原有同名文件**。cp命令的 -n(--no-clobber)选项可以防止覆盖已存在的文件。
在此阶段,您的项目文件夹内容应类似于以下内容:
```text
仓库根目录
└── .specify
├── memory
│ └── constitution.md
├── scripts
│ ├──bash
│ │ ├── check-prerequisites.sh
│ │ ├── common.sh
│ │ ├── create-new-feature.sh
│ │ ├── setup-plan.sh
│ │ └── update-claude-md.sh
│ ├──powershell
│ │ ├── check-prerequisites.ps1
│ │ ├── common.ps1
│ │ ├── create-new-feature.ps1
│ │ ├── setup-plan.ps1
│ │ └── update-claude-md.ps1
├── specs
│ └── 001-create-taskify
│ └── spec.md
└── templates
├── plan-template.md
├── spec-template.md
└── tasks-template.md
```
2. **生成一个简洁的短名称**(2-4个词)用于分支:
- 分析功能描述并提取最有意义的关键词
- 创建一个2-4个词的短名称,捕捉功能的本质
- 尽可能使用动词-名词格式(例如:"add-user-auth"、"fix-payment-bug")
- 保留技术术语和缩写(OAuth2、API、JWT等)
- 保持简洁但足够描述性,以便一目了然地理解功能
- 示例:
- "我想添加用户认证" → "user-auth"
- "为API实现OAuth2集成" → "oauth2-api-integration"
- "创建分析仪表板" → "analytics-dashboard"
- "修复支付处理超时错误" → "fix-payment-timeout"
3. **在创建新分支前检查现有分支**:
a. 首先获取所有远程分支以确保拥有最新信息:
```bash
git fetch --all --prune
```
b. 查找短名称在所有来源中的最高功能编号:
- 远程分支:`git ls-remote --heads origin | grep -E 'refs/heads/[0-9]+-<short-name>$'`
- 本地分支:`git branch | grep -E '^[* ]*[0-9]+-<short-name>$'`
- 规范目录:检查匹配 `specs/[0-9]+-<short-name>` 的目录
c. 确定下一个可用编号:
- 提取所有三个来源的所有数字
- 找到最大数字N
- 对于新分支使用N+1
d. 使用计算出的编号和短名称运行脚本 `create-new-feature.ps1 -Json "$ARGUMENTS"`:
- 传递 `--number N+1` 和 `--short-name "your-short-name"` 以及功能描述
- Bash示例:`create-new-feature.sh -Json "$ARGUMENTS" --json --number 5 --short-name "user-auth" "添加用户认证"`
- Po