# 阶段 2 — RIA++ 构造 skill

## 目标

把阶段 1.5 通过的每个方法论单元,构造成一个符合 Claude Code skill 规范的 SKILL.md。

使用模板: `templates/SKILL.md.template`

## RIA++ 六段

### R — Reading (原文)

- 直接引用 ≤150 字 (英文原文 ≤100 词)
- 必须标注出处 (章节 / 页码 / 段落标识; 视频填时间戳或分 P, 播客填集数)
- 若原书是英文,引用英文原文 + 你自己翻译的中文,**不要用现成译本** (避免译者版权 + 译本可能失真)

### I — Interpretation (自述)

- 用**你自己的话**重写方法论的核心骨架
- 5–15 行
- 检查: 读完这段,一个没读过原书的人能否理解这个方法论在做什么? 若不能,重写。
- 禁止: 照搬原文句子 / 堆砌修辞

### A1 — Past Application (书中案例)

- 作者在书中**亲自**用这个方法论处理过的具体案例
- 至少 1 条,≤3 条
- 每条要点明: 遇到什么问题 → 怎么用这个方法论 → 得出什么结论 → 实际结果如何

这一段的作用是让 skill 在被调用时,agent 有具体的类比素材可用。

### A2 — Future Trigger ★ (最关键)

**这决定了 skill 是否真的会被用起来。**

必须明确:
1. **用户会在什么情境下遇到这类问题?** (场景描述, 3–5 条)
2. **这些情境的语言信号是什么?** (用户会说什么样的话)
3. **和哪些相邻 skill 不同?** (避免和其他 skill 互相抢调用)

A2 的产出直接写入 skill frontmatter 的 `description` 字段 — Claude 据此决定是否激活 skill。

注意:
- "与相邻 skill 的区分"在本阶段只写**初稿** (依据 verified.md 的单元列表推测),阶段 3 建立链接关系后回填定稿 — 不要在本阶段硬编相邻关系。
- 语言信号建议**中英双写**关键 trigger 词 (用户可能用英文提问,纯中文 description 会降低触发准确率)。

**好的 A2 示例** (来自"逆向思维" skill):
> 用户在纠结一个决策、列举正面理由却理不出头绪时;或在问"怎么做 X 才能成功"时;不适用于纯信息查询类问题。

**坏的 A2 示例**:
> 用户需要思考时。 ← 太宽泛,会误激活

### E — Execution (可执行步骤)

- 把方法论转成 1-2-3 步骤
- 每一步有**可判断的完成标准**
- 如果有判停点 (step 2 之后若 X 则跳到 step 5),显式写出

E 的作用是让 agent 在调用这个 skill 时有明确的执行路径,不是"自由发挥"。

### B — Boundary (边界)

- 什么时候**不要**使用这个 skill (反场景)
- 作者在书里警告过的失败模式
- 来自阶段 0 批判阶段的作者盲点
- 与之相邻但容易混淆的其他方法论

B 的作用是**防止乱调用**。没有 B 的 skill,会在不该用的时候被用,反而帮倒忙。

## Frontmatter 设计

```yaml
---
name: <skill-slug>                    # kebab-case, 唯一
description: |                        # A2 的浓缩版, ≤300 字
  <何时用 + 何时不用 + 关键 trigger>
source_book: 《穷查理宝典》 查理·芒格
source_chapter: 第三讲
tags: [decision, mental-model, cognitive-bias]
related_skills: []                    # 阶段 3 填充
---
```

## 常见失败模式

1. **I 段写成书摘** — 如果读起来像"本章作者说了 X",你在抄书不是在解释。重写。
2. **A2 太宽** — "需要决策时" 这种 trigger 永远不会被精准调用。必须给出**可识别的语言信号**。
3. **E 段只有哲学没有动作** — "保持客观" 不是 step,"列出 3 个最不希望发生的结果" 才是。
4. **缺 B 段** — 没边界的 skill 会被过度调用,最终用户失望。
5. **从 I 直接跳到 E,跳过 A1** — 丢失了"作者亲自用过"的证据,skill 失去权威性。