vibe_coding/.cursor/skills/skill-creator/SKILL.md

name, version, description

name	version	description
skill-creator	1.0.0	为项目创建新的 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

使用以下模板：

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