什么是 Skill

Skill 是 Claude Code 的自定义技能机制，允许用户定义可复用的工作流程。Skill 本质上是带有 frontmatter 的 Markdown 文件，描述了 Claude 在特定场景下应该如何行动。

用户通过 /skill-name 斜杠命令调用 Skill，Claude 会加载 Skill 的完整内容并据此执行任务。

Skill 文件结构

---
name: skill-name
description: 简短描述，用于匹配用户意图
---

Skill 的具体指令内容...

Frontmatter 字段

字段	必填	说明
name	是	Skill 名称，也是斜杠命令名
description	是	描述何时触发此 Skill

Skill 存放位置

Skill 文件可以放在以下位置：

位置	作用域
~/.claude/skills/	全局 Skill，所有项目可用
.claude/skills/	项目级 Skill，仅当前项目可用

编写 Skill

示例：代码审查 Skill

---
name: review
description: 对当前改动进行代码审查
---

请对当前 git diff 中的改动进行代码审查：

1. 运行 `git diff` 查看所有改动
2. 检查以下方面：
   - 代码逻辑是否正确
   - 是否有潜在的性能问题
   - 是否遵循项目的编码规范
   - 是否有安全隐患
3. 以列表形式输出发现的问题和改进建议

示例：组件生成 Skill

---
name: gen-component
description: 生成 React 组件模板
---

根据用户提供的组件名，生成以下文件：

1. `src/components/{ComponentName}/index.tsx` — 组件主文件
2. `src/components/{ComponentName}/styles.module.css` — 样式文件
3. `src/components/{ComponentName}/{ComponentName}.test.tsx` — 测试文件

使用项目约定：
- 函数组件 + TypeScript
- CSS Modules 样式方案
- 使用 vitest + @testing-library/react 测试

示例：知识库内容生成 Skill

---
name: kb
description: 为知识库生成内容，自动匹配正确的目录、frontmatter 格式和侧边栏配置
---

根据用户需求生成知识库文档：
1. 分析内容主题，确定所属分类和目录
2. 生成符合规范的 frontmatter
3. 如需要，更新侧边栏配置

Skill 调用方式

在交互模式中输入：

/review
/gen-component Button
/kb 生成一篇关于 Docker 的笔记

也可以在非交互模式中使用：

claude -p "/review"

编写建议

• 明确触发条件：description 要清晰描述何时使用此 Skill
• 步骤化指令：将复杂流程拆解为有序步骤
• 包含约束：明确输出格式、命名规范等限制
• 保持聚焦：一个 Skill 做一件事，避免大而全