96 lines
2.3 KiB
Markdown
96 lines
2.3 KiB
Markdown
---
|
||
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 个不同的提示词测试技能是否正确触发
|