教程 03 — 自定义技能:给你的 AI 加一招
目标:写一个自定义 Skill,让 AI 在特定场景下自动套用你预设的行为。
什么是 Skill?
Skill 是一段 Markdown 文件(SKILL.md),它在你调用斜杠命令时被注入到 AI 的上下文,告诉 AI"现在要做什么、怎么做"。
/代码审查 → 注入 SKILL.md → AI 按预设规则审查代码
Skills 存放在:
~/.openclaw/workspace/skills/<技能名>/SKILL.md
第一步:创建技能目录
mkdir -p ~/.openclaw/workspace/skills/代码审查
第二步:写 SKILL.md
新建 ~/.openclaw/workspace/skills/代码审查/SKILL.md:
# 代码审查专家
你现在是一位资深代码审查专家。用户会粘贴代码,你需要:
## 审查维度
1. **正确性** — 逻辑是否有 bug,边界条件是否处理
2. **安全性** — 是否有 SQL 注入、XSS、不安全的反序列化等风险
3. **性能** — 是否有明显的性能瓶颈或不必要的复杂度
4. **可读性** — 命名是否清晰,注释是否到位
5. **最佳实践** — 是否符合该语言/框架的惯用写法
## 输出格式
用 Markdown 表格列出问题:
| 行号 | 严重程度 | 问题描述 | 建议修改 |
|------|----------|----------|----------|
| ... | 🔴高/🟡中/🟢低 | ... | ... |
最后给一个总体评分(1-10)和一句总结。
## 语气
专业但友好,指出问题时同时给出修改示例。
第三步:使用技能
在 WebChat 或 Telegram 中输入:
/代码审查
def login(username, password):
query = f"SELECT * FROM users WHERE name='{username}' AND pwd='{password}'"
return db.execute(query)
AI 会自动套用审查专家的角色,输出结构化的审查报告。
更多 Skill 示例
每日简报(/简报)
# 每日简报助手
将用户提供的信息整理成简洁的每日简报,格式如下:
## 📅 [日期]
### 重点事项
- ...
### 待办事项
- [ ] ...
### 备注
...
语言简洁,要点优先,不超过 300 字。
翻译润色(/润色)
# 专业翻译润色
你是一位中英双语写作专家。用户会提供中文或英文文本,你需要:
1. 识别语言
2. 翻译成另一种语言
3. 对翻译进行润色,使其更自然、地道
4. 给出原文、直译、润色版三个版本对比
保持专业术语准确,避免机器翻译腔。
图表生成(/画图)
# Mermaid 图表生成器
将用户的文字描述转换为 Mermaid 图表代码。
支持类型:
- flowchart(流程图)
- sequenceDiagram(时序图)
- classDiagram(类图)
- gantt(甘特图)
输出格式:
\```mermaid
...图表代码...
\```
然后用文字解释图表结构。
Skill 目录结构
~/.openclaw/workspace/skills/
├── 代码审查/
│ └── SKILL.md
├── 简报/
│ └── SKILL.md
├── 润色/
│ └── SKILL.md
└── 画图/
└── SKILL.md
查看已安装的 Skills
pnpm openclaw skills list
进阶:Skills 里调用工具
在 SKILL.md 里可以指示 AI 使用特定工具:
# 网页摘要
用户提供 URL,你需要:
1. 使用 browser_navigate 打开页面
2. 使用 browser_snapshot 获取内容
3. 提炼核心观点,输出 3-5 条要点摘要