教你写一个最简单的Claude Skill：给AI套上"人设"

Claude Code 有一个非常好用的功能叫 "Skills"——一种可复用的智能指令系统。

今天我手把手教你写最简单的一类 Skill：角色型 Skill。

什么是"角色型 Skill"？

先搞清楚一个概念：

Skill 本质上就是给 Claude 写的"说明书"。

而"角色型 Skill"是最基础的一种——

它的作用就是：给 AI 套上一个固定人设。

举几个例子：

• 👨‍💻 代码审查官：专门 review 你的代码，挑刺贼准
• 📝 科技博主：写文章自带网感，段子信手拈来
• 🎯 面试官模拟器：模拟大厂面试，帮你查漏补缺
• 🧘 冥想导师：用舒缓语气引导放松，绝不催促

这些都是典型的角色型 Skill。

为什么要写成 Skill，而不是每次都发 Prompt？

好问题。

你当然可以每次对话开头贴一大段人设描述。

但问题是：

• ❌ 重复劳动：每次新对话都要复制粘贴
• ❌ 不便协作：团队成员拿不到你的"调教成果"
• ❌ 难以迭代：改进版本散落在各个聊天记录里

而 Skill 的好处：

• ✅ 一次编写，永久生效——Claude 识别并加载
• ✅ 版本可控——Git 管理，团队共享
• ✅ 模块化设计——不同场景激活不同 Skill

这就是 "Prompt 工程化" 的精髓。

动手写一个：代码审查官人设

下面直接上实战。

我们来写一个「代码审查官」角色——专门帮你 review 代码、挑 bug 的 AI 分身。

第一步：创建目录结构

在你的项目根目录下创建这样的结构：

.claude/
└── skills/
    └── code-reviewer/        # skill 文件夹
        ├── SKILL.md          # 入口文件（必须叫这个名）
        └── persona/          # 角色定义目录
            └── code_reviewer.md

关键点：

1. 必须放在 .claude/skills/ 目录下
2. SKILL.md
    是入口，Claude 靠它识别这是一个 Skill
3. 角色描述放在 persona/ 子目录——这是推荐的组织方式

第二步：编写 SKILL.md 入口文件

---
trigger: "review代码|代码审查|帮我看看这段代码"
description: "激活代码审查官人设进行代码评审"
---

# 代码审查官 Skill

## 触发方式

当用户说：
- "帮我 review 这段代码"
- "看看这个函数有什么问题"

## 执行流程

1. **加载人设**：读取 `persona/code_reviewer.md`
2. **按风格审查**：严格遵循角色设定中的审查规范
3. **输出审查报告**

这个文件的作用：

• trigger
  ：告诉 Claude "什么时候"激活这个 Skill
• description
  ：给 Claude 的一句话说明
• 正文：具体的执行步骤指南

第三步：编写角色人设文件

这才是真正的灵魂所在。

在 persona/code_reviewer.md 里写：

# 代码审查官人设

## 你的身份

你是一位资深代码审查专家，代号"代码审查官"。
审查风格严谨但不刻薄，善于发现隐藏 bug 和性能隐患。

## 审查风格

### 输出结构
- 先给出总体评价（优/良/需改进）
- 分类列出问题：🔴 严重 / 🟡 警告 / 🔵 建议
- 每个问题附带修复建议

### 审查维度
- **正确性**：逻辑错误、边界条件
- **可读性**：命名、注释、代码结构
- **性能**：时间复杂度、内存泄漏
- **安全性**：SQL注入、XSS、敏感信息

### 沟通风格
- 用"建议"而非"必须"
- 解释"为什么"这样改更好
- 对优秀代码给予肯定 👍

### 代码示例
- 给出修改前后的对比
- 用 diff 格式展示改动

## 禁忌

- 禁止人身攻击或嘲讽
- 禁止只说"有问题"不说怎么改
- 禁止过度追求完美主义

激活测试

写完就能用了！

打开 Claude Code，随便开个新对话，输入：

帮我 review 这段代码：

def get_user(id):
    return db.query(f"SELECT * FROM users WHERE id = {id}")

如果 Skill 配置正确，Claude 会：

1. 识别触发词「review 代码」
2. 加载你的「代码审查官」人设
3. 按你定义的风格输出审查报告（比如立刻指出 SQL 注入风险 🔴）

恭喜，你拥有了一个专属的AI写作分身！

进阶技巧

掌握基础之后，你还可以：

1. 多角色切换

给不同场景写不同人设：

.claude/skills/
├── tech-blogger/     # 科技博主
├── code-reviewer/    # 代码审查官
└── interview-coach/  # 面试教练

Claude 会根据你的指令选择激活哪一个。

2. 人设 + 工具 结合

角色型 Skill 可以和其他类型组合——

比如「编剧」+「分镜图」+「生成式渲染」=「电影」。

这就是 Skill 的模块化威力。

3. 团队共享

把 .claude/skills/ 目录提交到 Git 仓库：

• 团队成员 clone 下来就能用
• 统一代码风格，保证品牌调性

总结

今天我们学了：

1. 角色型 Skill
    是给 AI 设定固定人设的最简单 Skill 类型
2. 核心三文件：SKILL.md（入口）+ persona/*.md（人设）
3. 触发词 + 人设描述 = AI 专属分身

一句话：与其每次调教 AI，不如写个 Skill 一劳永逸。