今天我手把手教你写最简单的一类 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
关键点:
-
必须放在 .claude/skills/目录下 SKILL.md
是入口,Claude 靠它识别这是一个 Skill -
角色描述放在 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 会:
-
识别触发词「review 代码」 -
加载你的「代码审查官」人设 -
按你定义的风格输出审查报告(比如立刻指出 SQL 注入风险 🔴)
恭喜,你拥有了一个专属的AI写作分身!
进阶技巧
掌握基础之后,你还可以:
1. 多角色切换
给不同场景写不同人设:
.claude/skills/
├── tech-blogger/ # 科技博主
├── code-reviewer/ # 代码审查官
└── interview-coach/ # 面试教练
Claude 会根据你的指令选择激活哪一个。
2. 人设 + 工具 结合
角色型 Skill 可以和其他类型组合——
比如「编剧」+「分镜图」+「生成式渲染」=「电影」。
这就是 Skill 的模块化威力。
3. 团队共享
把 .claude/skills/ 目录提交到 Git 仓库:
-
团队成员 clone 下来就能用 -
统一代码风格,保证品牌调性
总结
今天我们学了:
- 角色型 Skill
是给 AI 设定固定人设的最简单 Skill 类型 -
核心三文件: SKILL.md(入口)+persona/*.md(人设) -
触发词 + 人设描述 = AI 专属分身
一句话:与其每次调教 AI,不如写个 Skill 一劳永逸。

