15 · Skills 技能
Cursor Skills：可复用的可选工作流，让你的 AI 搭档学会”专业技能”。
01 Skills 是什么
Skills 是 Cursor 中的可复用工作流模板。你可以把 Skills 理解为”给 AI 写的标准操作流程（SOP）“——当你激活某个 Skill 时，AI 按照预定义的步骤和规范来执行特定类型的任务。
存储位置：.cursor/skills/ 目录下。
Skills 和 Rules 的区别：
| 维度 | Rules | Skills |
|---|---|---|
| 触发方式 | 自动（根据 globs / alwaysApply） | 手动激活（@skill-name） |
| 作用 | 设定 AI 的行为约束和偏好 | 定义 AI 执行某类任务的标准流程 |
| 比喻 | 像公司规章制度 | 像标准操作手册 |
| 何时用 | ”始终遵循这些规范" | "做这类事时按这个流程来” |
02 Skills 的结构
一个 Skill 就是一个 Markdown 文件，放在 .cursor/skills/ 目录下：
.cursor/
skills/
test-loop.md ← 跑测试 → 修 Bug → 再跑的 TDD 循环
code-review.md ← 代码审查的标准流程
refactor.md ← 重构的步骤规范
api-design.md ← API 设计的 checklistSkill 文件示例
.cursor/skills/test-loop.md：
# Test Loop Skill
当用户说 "test loop" 或 "tdd" 时激活。
## 流程
1. 先阅读当前的测试文件，理解已有的测试覆盖
2. 写一个新的测试用例，描述期望行为
3. 运行测试，确认新测试 FAIL（红）
4. 写最少量的代码让测试 PASS（绿）
5. 运行全部测试，确认没有回归
6. 如果代码有可改进之处，重构（重构后跑测试确认依然绿）
7. 向用户报告：写了什么测试、改了什么代码、测试结果
## 规范
- 每个测试只测一件事
- 测试命名遵循 `should_<行为>_when_<条件>` 格式
- 重构只在绿灯状态下进行03 如何使用 Skill
激活 Skill
在 Chat 或 Composer 中输入 @skill-name 来激活：
@test-loop 给 UserService 加上邮箱验证的测试AI 会按照 Skill 中定义的流程来执行这个任务。
查看可用 Skills
在 Chat 中输入 @ 然后选择 Skills 分类，会列出所有可用 Skills。
团队共享 Skills
Skills 可以通过 Git 提交到项目仓库，所有团队成员自动获得相同的 Skills。这是统一团队开发规范的有效方式。
04 常见 Skill 模板
以下是几个高价值的 Skill 模板：
Code Review Skill
# Code Review Skill
## 流程
1. 阅读 git diff，理解所有改动
2. 检查：逻辑正确性、边界情况、错误处理、性能隐患、安全漏洞
3. 检查代码风格是否符合项目规范
4. 检查是否有重复代码可以提取
5. 生成 review 报告：发现的问题 + 修改建议 + 严重程度
## 输出格式
- 🔴 严重：必须修复
- 🟡 建议：推荐修改
- 🟢 好评：写得好的地方Refactor Skill
# Refactor Skill
## 流程
1. 确认重构目标（提取函数？拆分文件？改设计模式？）
2. 先确保有测试覆盖
3. 小步重构，每步跑测试
4. 不改变外部行为——只改实现方式
5. 完成后对比重构前后的代码行数/复杂度New Feature Skill
# New Feature Skill
## 流程
1. 理解需求 → 如有模糊之处提问澄清
2. 设计方案 → 列出涉及的文件和改动点
3. 先写类型定义/接口
4. 实现核心逻辑
5. 加错误处理和边界情况
6. 写测试
7. 更新相关文档（如有）
8. 自检：跑全部测试 → 确认绿了 → 报告完成05 Skills vs Slash Commands vs Hooks
| 机制 | 用途 | 触发 | 复杂度 |
|---|---|---|---|
| Skills | 定义任务执行的标准流程 | 手动 @激活 | 中 |
| Slash Commands | 一键触发特定操作 | /命令 | 低 |
| Hooks | 事件触发的自动化 | 自动（Pre/Post 事件） | 高 |
简单来说：
- 想让 AI 每次做某类事都按固定流程来 → 用 Skills
- 想一键执行某个常用操作 → 用 Slash Commands
- 想在特定事件发生前后自动执行脚本 → 用 Hooks
06 小结
| 要点 | 说明 |
|---|---|
| Skills 是什么 | 可复用的 AI 工作流模板 |
| 存哪里 | .cursor/skills/ 目录 |
| 怎么用 | 在对话中 @skill-name 激活 |
| 和 Rules 的区别 | Rules 是约束，Skills 是流程 |
| 最佳场景 | TDD、Code Review、重构、新功能开发 |
下一篇：16 Hooks 钩子 —— 用 Hooks 在 AI 操作的特定时机自动执行你的脚本。