---
name: skill-creator
version: 1.0.0
description: "为项目创建新的 Agent 技能。当需要将可复用流程固化为技能或创建新 SKILL.md 时使用。"
---

# Skill Creator

## 触发条件

用户要求创建、添加、修改技能（skill），或要求 Agent 学习新的工作流程。

## 执行流程

### 1. 需求收集

向用户确认以下信息（缺什么问什么）：

| 字段 | 必填 | 说明 |
|------|------|------|
| name | ✅ | kebab-case，匹配 `^[a-z0-9]+(-[a-z0-9]+)*$` |
| description | ✅ | ≤1024 字符，说明做什么 + 什么时候用 |
| 触发场景 | ✅ | 用户会用什么自然语言触发这个技能？ |
| 执行步骤 | ✅ | 技能执行的具体步骤 |
| 需要 references？ | ❌ | 是否有深度文档需要附带 |
| 需要 scripts？ | ❌ | 是否有可执行脚本 |

### 2. 生成目录结构

```
.cursor/skills/<skill-name>/
├── SKILL.md              # 必须
├── references/           # 可选：深度文档
│   └── *.md
├── scripts/              # 可选：自动化脚本
│   └── *.sh / *.ts
└── assets/               # 可选：模板文件
    └── *.template
```

### 3. 编写 SKILL.md

使用以下模板：

```markdown
---
name: <kebab-case-name>
version: 1.0.0
description: "<一句话说明做什么>。Use when <触发场景的英文描述>。 <补充说明触发关键词：中英文都覆盖>。"
---

# <技能标题>

## 触发条件

<什么场景下使用此技能。>

## 执行流程

### 1. <步骤标题>
<具体、可执行的指令>

### 2. <步骤标题>
<具体、可执行的指令>

## 模板（如有）

<代码模板>

## 验证

完成后验证：
1. [ ] <检查项 1>
2. [ ] <检查项 2>
```

### 4. 质量检查

- [ ] `name` 符合 `^[a-z0-9]+(-[a-z0-9]+)*$`
- [ ] `description` ≤ 1024 字符
- [ ] description 包含中英文触发关键词
- [ ] 步骤用编号，每步可独立执行
- [ ] SKILL.md 总行数 < 300 行
- [ ] 包含验证/检查步骤

### 5. 注册到 003-skills.mdc

将新技能添加到 `.cursor/rules/003-skills.mdc` 的技能目录表中。

## 验证

创建完成后：
1. 确认 `SKILL.md` 存在且格式正确
2. 用 `skillport validate` 或手动检查 YAML frontmatter
3. 用 3 个不同的提示词测试技能是否正确触发