Claude Skills
CollectionsCompareWorkflowsNominate
Sign inSign up
© 2026 Curated Agent Skills·Learn more about Agent Skills
Back to repository

speckit-specify-zh

verified

中文功能规范创建工具,用于将自然语言功能描述转换为结构化的功能规范文档。支持自动生成分支名称、创建Git分支、初始化规范文件和质量验证。触发词包括:"speckit规范"、"功能规范"、"创建规范"、"功能描述转换"、"speckit-specify"。当用户需要将功能想法转换为结构化规范时使用此技能。

View on GitHub

Marketplace

open-skilled-sdd-marketplace

forztf/open-skilled-sdd

Plugin

open-skilled-sdd

Repository

forztf/open-skilled-sdd
4stars

skills/speckit-specify-zh/SKILL.md

Last Verified

February 1, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/forztf/open-skilled-sdd/blob/main/skills/speckit-specify-zh/SKILL.md -a claude-code --skill speckit-specify-zh

Installation paths:

Claude
.claude/skills/speckit-specify-zh/
Powered by add-skill CLI

Instructions

## 用户输入

```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

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
4806 chars