第2课：Skill 里面有什么？
Skill & Agent 模块 · 2/4
先定调：这节课不是"必须课"
你不需要知道 skill 里面长什么样才能用它。就像你不会拆开手机才能打电话。
那为什么要学？因为当 AI 给你创建了一个 skill，你想看看它写得好不好、缺了什么、有什么要改的——这时候你就需要能读懂它。
💡 读 skill 的能力 ≈ 给 AI 反馈的能力。
你都不用打开文件来看，你直接用一条反馈"这里再加一条规则"就让 AI 帮你改了。但如果你能快速扫一眼 AI 写的 skill，你的反馈会更精准。
先看一个真实的例子
你之前写过 clarify-first，我们来看看它里面有什么。直接在 Hermes 里运行：
skill_view(name='clarify-first')
你会看到一大堆文字。别怕，其实就 3 部分：
第 ① 部分：ID 卡（最上面的几行）
name: clarify-first
description: 先追问再回答
version: 1.1.0
author: hpl
就是名字、简介、版本号、谁写的。跟一本书的封面一样——扫一眼就知道这是什么。
第 ② 部分：规则（最核心的部分）
## Behavior Rules
1. 先提问，不回答。
2. 一次只问一个问题。
3. 迭代追问。
4. 95% 信心阈值。
5. 透明说明。
这是 AI 实际执行的操作步骤。你读这部分就知道"AI 会怎么做这件事"。
如果你觉得哪里不对，你直接说："把第 2 条改成一次最多问两个问题"——AI 就会帮你改。
第 ③ 部分：陷阱清单（最有价值的部分）
### 不要做的事
- ❌ 一次问多个问题
- ❌ 追问过度
- ❌ 在凌晨追问用户
- ❌ 在等价选项中追问"你想用哪个"
这些是你自己的经验教训。你踩过的坑、用起来不爽的地方，写在这里 AI 就不会再犯了。
总结：skill 的结构就这 3 样
| 部分 | 就像…… | 你怎么反馈 |
|---|
| ID 卡 | 书的封面 | "这个名字起得不好" |
| 规则 | 操作说明书 | "第三步不对，改成先验证再输出" |
| 陷阱清单 | ⚠️ 警示贴纸 | "加一条：不要一上来就推销" |
你看，你不需要会写 skill_manage(action='create')，你只需要会说这三句话：
- "帮我建一个 XXX 的 skill"
- "这个规则不对，改成这样"
- "再加一条：不要做 XXXX"
实操：看懂一个你正在用的 skill
- 在对话框中输入
skill_view(name='clarify-first')
- 找到"ID 卡"、"规则"、"陷阱清单"这 3 块
- 看看有没有你想要修改的地方
- 直接说"帮我把 XXX 改成 XXX"
自我检查
✅ 检查你的理解
- Skill 只需要看哪 3 部分就够了？
- 你不知道怎么写 skill 文件，有没有办法创建 skill？
- 实操：用 skill_view 看一个你不熟悉的 skill（比如 teach 或 github-pr-workflow），找到它的规则和陷阱清单