Skills 技能扩展

Skills 是 Claude Code 的可复用工作流，把日常重复的任务封装成 Markdown 文件。Claude 自动按场景激活。

跟 Slash Commands 的区别

Slash Command — 你主动 /xxx 触发
Skill — Claude 看到任务匹配自动激活

为什么用 Skills

每天都做"代码审查、生成 changelog、写 commit message"等重复操作 → 不要每次粘 200 字提示词，写一次 SKILL.md，永久受用。

一句话原则

每天做超过一次的操作，就该写成 Skill。

Skill 文件结构

~/.claude/skills/                ← 个人级
└── my-skill/
    └── SKILL.md                 ← 必须叫这个名

或

<项目根>/.claude/skills/         ← 项目级
└── my-skill/
    └── SKILL.md

SKILL.md 模板

markdown

---
name: code-review
description: 当用户要求代码审查、看 PR、review changes 时自动激活
---

# 代码审查 Skill

你正在执行一次代码审查。按以下步骤：

## 1. 获取 diff
跑 `git diff HEAD~1` 看本次改动。

## 2. 审查维度
- 🔒 **安全**：SQL 注入、XSS、密钥泄露
- 🐎 **性能**：N+1 查询、不必要的 re-render
- 🧪 **测试**：新逻辑是否有测试
- 📚 **可读性**：命名、注释、复杂度
- 📐 **规范**：看 CLAUDE.md 里的约定

## 3. 输出格式
\`\`\`
🔴 必改
- <文件:行号> <问题描述> <建议>

🟡 建议
- ...

🟢 亮点
- ...
\`\`\`

## 4. 用 todo 工具
逐个跟踪发现，最后汇总。

加载机制（关键）

Skills 启动时只加载元数据（name + description，约 100 token），任务匹配时才读取完整指令。几十个 skills 同时启用也不挤占 context。

匹配逻辑：

你输入："帮我审一下这个 PR"
    ↓
Claude 扫描所有 skills 的 description
    ↓
匹配到 code-review 的 description
    ↓
加载完整 SKILL.md 注入 context
    ↓
按 SKILL 指令执行

description 写法（决定匹配率）

❌ 不好

yaml

description: 代码审查工具

✅ 好

yaml

description: 当用户要求代码审查、看 PR、看 diff、review changes、code review 时自动激活

写触发短语而非"功能描述"，越具体越准。

复杂 Skill：多文件

~/.claude/skills/refactor/
├── SKILL.md                ← 主入口
├── patterns/
│   ├── extract-function.md
│   ├── inline-variable.md
│   └── rename-symbol.md
└── examples/
    └── before-after.md

SKILL.md 里引用：

markdown

对于"提取函数"场景，请按 patterns/extract-function.md 的步骤。

Claude 会按需 read 这些文件。

实战例子：3 个超有用的 Skill

1. /commit 自动生成 commit message

markdown

---
name: smart-commit
description: 当用户说要 commit / 提交代码 / generate commit message 时激活
---

# 智能 commit

1. 跑 `git diff --staged` 看暂存改动
2. 按 conventional commit 格式生成：
   - feat: 新功能
   - fix: bug 修复
   - refactor: 重构
   - docs: 文档
   - test: 测试
3. 标题 ≤ 50 字符
4. 正文用 bullet 列具体改动
5. 如果有 breaking change 加 `BREAKING CHANGE:`
6. 跑 `git commit -m "..."`

不要加 Co-Authored-By Claude（按用户偏好）。

2. 写测试 skill

markdown

---
name: write-tests
description: 当用户要写测试、增加测试覆盖、test coverage 时激活
---

# 写测试

1. 读 CLAUDE.md 看测试框架（vitest / jest / pytest）
2. 看现有测试找规约（命名、目录、mock 风格）
3. 列 todo：每个边界条件一个测试
4. 写：
   - happy path
   - 边界值
   - 异常情况
   - 并发情况（如有）
5. 跑测试确认全过
6. 看覆盖率，缺的补

3. 数据库 migration

markdown

---
name: db-migration
description: 当用户要改数据库 schema / 加字段 / 加表 / 加索引时激活
---

# 数据库迁移

1. 看 prisma/schema.prisma 当前结构
2. 设计改动
3. ⚠️ 检查破坏性：
   - DROP COLUMN？ → 警告用户
   - 改类型？ → 警告需要数据迁移
4. 写 migration 文件
5. 用 prisma migrate dev 创建
6. 看生成的 SQL 确认
7. 跑 prisma generate 更新 client

Skills 发现平台（2026 新生态）

🌐 在线检索

平台	内容	URL
Skills.sh	Skills 搜索目录，按分类/作者/装机量排序	skills.sh
ClawHub	社区驱动的 Skills 平台，VirusTotal 安全扫描	clawhub.ai
FindSkills	87,000+ skills 开放目录	findskills.org
SkillHub	Claude / Agent Skills marketplace	skillhub.club
Cult of Claude	精选高质量 skills + 评测	cultofclaude.com

🚀 命令行安装

bash

# 用 findskills 命令行搜索
npx findskills "web scraping"

# Skills.sh 搜索
npx skills find "code review"

# ClawHub 安装
clawhub install <skill-name>

# 一键全平台安装到所有支持的 agent
npx agent-skills-cli add <skill-name>

仓库	内容	Stars / License
VoltAgent/awesome-agent-skills	1000+ skills，跨 Claude/Codex/Gemini	MIT
VoltAgent/awesome-openclaw-skills	5,400+ OpenClaw skills	MIT
alirezarezvani/claude-skills	245+ 工程/营销/产品/合规 skills	MIT
hesreallyhim/awesome-claude-code	精选 + 高质量	各异
rohitg00/awesome-claude-code-toolkit	35 skills + 135 agents	MIT
joneqian/claude-skills-suite	中文 skills 集合	待查
travisvn/awesome-claude-skills	单独 skills 精选	各异

一键安装

bash

# clone 到个人 skills 目录
cd ~/.claude/skills
git clone https://github.com/VoltAgent/awesome-agent-skills voltagent

# 重启 claude 即可识别

调试 Skill

/skills              # 看哪些 skill 加载了
/skill code-review   # 强制激活某个
/memory              # 看 Claude 当前的"思考"

如果 Claude 没自动激活你期望的 skill，看 description 写得够不够触发短语化。

Skills vs Subagents

	Skill	Subagent
状态	无状态（每次新启动）	无状态（独立 context）
共享内存	跟主对话同 context	独立 context
用途	复用提示词模板	委派复杂任务
例子	"代码审查清单"	"并行测 3 个方案"

详见 Subagents。

Skills 跨工具兼容性

工具	兼容 Claude Code Skills
Claude Code	✅ 原生
Codex CLI	⚠️ 部分兼容
Cursor	❌ 需手动转
Cline	❌ 需手动转

VoltAgent 的 skills 跨 4+ 工具兼容，是当前最通用的选择。

Skills 技能扩展 ​

为什么用 Skills ​

Skill 文件结构 ​

SKILL.md 模板 ​

加载机制（关键） ​

description 写法（决定匹配率） ​

❌ 不好 ​

✅ 好 ​

复杂 Skill：多文件 ​

实战例子：3 个超有用的 Skill ​

1. /commit 自动生成 commit message ​

2. 写测试 skill ​

3. 数据库 migration ​

Skills 发现平台（2026 新生态） ​

🌐 在线检索 ​

🚀 命令行安装 ​

热门 Skill 仓库（直接拿来用） ​

一键安装 ​

调试 Skill ​

Skills vs Subagents ​

Skills 跨工具兼容性 ​

Skills 技能扩展

为什么用 Skills

Skill 文件结构

SKILL.md 模板

加载机制（关键）

description 写法（决定匹配率）

❌ 不好

✅ 好

复杂 Skill：多文件

实战例子：3 个超有用的 Skill

1. /commit 自动生成 commit message

2. 写测试 skill

3. 数据库 migration

Skills 发现平台（2026 新生态）

🌐 在线检索

🚀 命令行安装

热门 Skill 仓库（直接拿来用）

一键安装

调试 Skill

Skills vs Subagents

Skills 跨工具兼容性