AI Skills 使用指南：可复用的专项能力

Skills 是给 AI 的「专项 SOP」——在特定任务上提供可复用的步骤与知识。系列导航见 总索引。

什么是 Skills？

Skills（技能） 是一种结构化的指令文档，教 AI 何时触发、如何执行某类专项任务。可理解为：

• 比 系统提示词 更聚焦（只覆盖一类任务）
• 比单次 用户提示词 更可复用（写一次，多次调用）
• 比 智能体 更轻量（通常是文档 + 规则，不必然含工具调用）

典型实现：Cursor 的 SKILL.md、Claude 的 Skills、LangGPT 结构化提示词框架。

四概念对比

何时使用 Skills？

适合：

• 反复执行的专业流程（写 PR、做 Code Review、发版检查）
• 需要固定步骤与检查清单的任务
• 团队希望统一 AI 行为标准

不适合：

• 一次性简单问答（用 User Prompt 即可）
• 需要实时调用多种外部 API 的复杂自动化（用 Agent）

Skills 典型结构

# Skill 名称
简短描述本 Skill 解决什么问题。

## 何时使用（触发条件）
- 用户要求 …
- 涉及 … 类型任务

## 前置条件
- 需要哪些文件 / 上下文

## 执行步骤
1. 第一步 …
2. 第二步 …
3. 第三步 …

## 输出格式
- 必须包含 …

## 注意事项
- 禁止 …
- 常见坑 …

实战示例

示例 1：Git 提交信息 Skill

# Git Commit Message Skill

## 何时使用
用户要求生成 commit message 或即将提交代码时。

## 执行步骤
1. 分析 git diff 的变更范围
2. 判断类型：feat / fix / docs / refactor / test
3. 用中文写 1~2 句说明「为什么」
4. 标题不超过 72 字符

## 输出格式
feat(scope): 简短标题

详细说明段落。

示例 2：Vue 组件审查 Skill

# Vue Component Review Skill

## 何时使用
审查 .vue 文件或用户提到 Vue 组件质量时。

## 检查清单
- [ ] 是否使用 Composition API + TypeScript
- [ ] 是否避免 any
- [ ] 复杂逻辑是否有注释
- [ ] onUnmounted 是否清理副作用
- [ ] Props 是否有类型定义

## 输出
Markdown 表格：问题 | 严重程度 | 建议

示例 3：技术博客 README 更新 Skill

# README Update Skill

## 何时使用
项目功能变更后需要同步 README 时。

## 执行步骤
1. 扫描本次改动的功能点
2. 在 README 对应章节增删说明
3. 若回退功能，删除相应 README 内容
4. 保持与现有 README 风格一致

## 约束
- 不添加用户未要求的新章节
- 使用中文

在 Cursor 中使用 Skills

1. 在 ~/.cursor/skills/ 或项目 .cursor/skills/ 创建 SKILL.md
2. Agent 会根据任务描述自动匹配相关 Skill
3. 也可在对话中明确：「按 xxx Skill 执行」

与 .cursorrules（偏全局 System Prompt）的区别：

编写原则

1. 触发条件清晰：避免 AI 误用或不用
2. 步骤可执行：每步可验证完成
3. 控制篇幅：单 Skill 建议 200~800 字
4. 与 System 分工：不重复全局规范
5. 纳入版本管理：团队共享、迭代优化

延伸阅读

• 系统提示词入门
• 用户提示词入门
• 智能体入门
• 总索引

本文由 xueyise 创作，提示词与智能体系列第 4 篇。