阶段 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 是否真的会被用起来。

必须明确:

用户会在什么情境下遇到这类问题? (场景描述, 3–5 条)
这些情境的语言信号是什么? (用户会说什么样的话)
和哪些相邻 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 设计

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

常见失败模式

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

3.7 KiB Raw Blame History Unescape Escape