Distill a book, long-video transcript, podcast, course, or interview into a coherent set of executable skills. Use when the user asks to "拆书" / "蒸馏一本书" / "把 XX 书做成 skill" / "把这个视频/播客/课程蒸馏成 skill" / "turn a book or video into skills" — i.e. wants the frameworks, principles, and methodologies in long-form content extracted into atomic, reusable Claude skills that an agent can invoke in real-world situations. NOT for simple summarization, book reviews, or role-playing as the author (that is nuwa-skill's job).
インストールする前に、エージェントに与えられる指示の中身を確認できます。
把一本书里沉淀的方法论,拆解成原子化、可被 agent 在真实场景下调用的能力,并按用户目的编译成合适数量的 skill,让读者真正用起来。
术语约定: 本文档及
methodology/、extractors/中所有的"书",泛指一切被蒸馏的长内容 — 书籍、长视频转写、播客文字稿、课程、访谈、长文、资料集。
边界:
一个五阶段 + 并行提取 + 三重验证 + 晋级门 + darwin 兼容测试的流水线。详见 methodology/00-overview.md。
阶段 0: Adler 整书理解 → BOOK_OVERVIEW.md
阶段 1: 5 个 agent 并行提取 → 候选方法论单元池
阶段 1.5: 三重验证筛选（知识验证） → 通过的单元 (用户轻确认)
阶段 1.6: 独立 Skill 晋级门（产品化验证）→ promoted / router 去向
阶段 2: RIA++ 构造能力卡 → .cangjie/capabilities/cards/<slug>.md
阶段 3: Zettelkasten 链接 → verified.yaml 的 also_read + GLOSSARY
阶段 4: 压力测试 (darwin 兼容) → 评测用例 + 回炉淘汰
阶段 5: 编译与交付 → cangjie.py compile（single/pack）+ DIGEST.md + 安装
v2.5 关键变化（ADR-002）: 阶段 2–4 不再直接把每个单元写成独立的最终 Skill 目录，而是产出一份 Capability Bundle（books/<slug>/.cangjie/capabilities/verified.yaml + cards/*.md）。single 与 pack 都从这同一份 Bundle 由 scripts/cangjie.py compile 确定性编译，两者引用同一组稳定 capability_id。旧的 one-to-one 输出仍受支持（legacy-pack，见 docs/migrations/2026-08-25-v2.0-to-v2.1.md）。
用户说类似:
在开始前必须从用户处确认:
脚本依赖: 确定性脚本(
scripts/)需要 Python 3.10+ 与 PyYAML(python3 -m pip install pyyaml)。缺 PyYAML 时先运行python3 scripts/cangjie.py doctor自检,它会给出安装指引。
非书籍内容的字段映射: 章节类字段对视频填时间戳或分 P,对播客填集数,对课程填讲次 — 保证可追溯即可。
books/<book-slug>/
├── PIPELINE_STATE.md # 流水线状态: 当前阶段 + 进度 (断点续跑用)
├── BOOK_OVERVIEW.md # 阶段 0 产出: 主旨/骨架/术语/批判
├── verified.md # 阶段 1.5 产出: 通过三重验证的单元 + 判定理由
├── coverage-audit.md # 原书关键任务 → 候选 → 判定 → 实际交付去向
├── references.md # 有依据但不执行的参考内容及交付映射
├── needs-review.md # 来源/条件/测试缺口；不编译为 active 能力
├── GLOSSARY.md # 阶段 3 产出: 全书共享术语词典
├── DIGEST.md # 阶段 5 产出: 面向读者的精华长文
├── candidates/ # 阶段 1 产出: 原始候选池 (审计用)
├── rejected/ # 阶段 1.5 淘汰的单元 + 原因 (审计用)
└── .cangjie/ # v2.5 侧车层（编译事实源 + 运行记录）
├── capabilities/
│ ├── verified.yaml # Capability Bundle（唯一编译事实源, capability-bundle.schema.json）
│ ├── cards/<slug>.md # RIA 能力卡（R/I/A1/A2/E/B, 阶段 2 产出）
│ ├── resources/ # 能力显式声明的 UTF-8 脚本、CSV/JSON/Markdown 模板（可选）
│ ├── destinations.json # 晋级/路由去向映射（阶段 1.6 产出）
│ └── book/{overview.md,glossary.md}
├── runs/<run-id>/ # 每次编译/更新的决策报告与校验日志
└── snapshots/ # 发布前快照（rollback 用）
最终交付物由 scripts/cangjie.py compile 从 Bundle 编译（--output single 得到 1 个入口 + 能力卡；--output pack 得到 1 个来源路由入口 + 少量晋级 Skill）。
断点续跑: 开始前先检查 books/<slug>/PIPELINE_STATE.md 是否存在。存在则读取并从记录的阶段续跑,不要从头重来。每完成一个阶段,更新该文件。
methodology/01-stage0-adler.md 中的 Adler 四步 (结构 / 解释 / 批判 / 应用)。templates/BOOK_OVERVIEW.md.template 填充,写入 books/<slug>/BOOK_OVERVIEW.md。并行 spawn 5 个 Task sub-agents(使用 Agent 工具,一次调用中发起 5 个):
| sub-agent | 读取的 prompt | 上下文策略 | 产出 |
|---|---|---|---|
| 框架提取器 | extractors/framework-extractor.md | 全量扫描（兼顾跨章节与单处完整机制） | 决策框架 / 思维模型 / 流程 / 排障 |
| 原则提取器 | extractors/principle-extractor.md | 全量扫描（含公式、表格、脚注） | 原则 / 清单 / 规则 / 计算口径 |
| 案例提取器 | extractors/case-extractor.md | 检索式取块（局部命中型） | 书中实例、转述案例、例题，标明类型 |
| 反例提取器 | extractors/counter-example-extractor.md | 检索式取块（局部命中型） | 书中警告的失败模式 |
| 术语提取器 | extractors/glossary-extractor.md | 检索式取块 + 脚本预筛 | 关键概念词典 |
每个 sub-agent 独立判断、独立输出到 books/<slug>/candidates/<type>.md。
methodology/02-stage1-parallel-extract.md 的分块策略处理；已建立内容索引（.cangjie/index/）时,检索式 extractor 按索引取相关块。读取 methodology/03-stage1.5-triple-verify.md,对每个候选单元执行:
按 verified / reference / needs_review / rejected 分流，记录依据及缺口；参考内容须映射到实际交付的 overview/glossary，不是所有未通过项都淘汰。更新 coverage-audit.md。
用户轻确认 ★: 展示可执行候选、参考、待核查、淘汰四类及重要缺口，再进入阶段 1.6；确认不能替代来源验证。
读取 methodology/03b-stage1.6-promotion-gate.md。知识验证通过 ≠ 值得成为独立 Skill。对每个单元评审五条判据（独立意图/独立契约/独立运行/独立复用/独立评测,前 3 条必须通过,后 2 条至少 1 条),把去向写入 Bundle 的 promotion.destination（promoted / router）。未晋级单元不淘汰,保留为来源路由入口内的能力卡。可发现入口软预算默认 8（含 1 个来源路由入口）。
对每个通过的单元,按 methodology/04-stage2-ria-plus.md 构造 R / I / A1 / A2 / E / B 六段能力卡:
books/<slug>/.cangjie/capabilities/cards/<slug>.md（不带 frontmatter,frontmatter 数据记入 Bundle）;verified.yaml 登记该能力: 稳定 capability_id、intents、keywords、one_liner、importance（附依据）、frontmatter.description（A2 浓缩版）。resources 显式声明配套文本资源，见阶段 2 说明。按 methodology/05-stage3-zettelkasten.md:
also_read,并回填 A2 的"与相邻能力的区分"candidates/glossary.md 整理成 books/<slug>/GLOSSARY.md,并复制到 .cangjie/capabilities/book/glossary.mdreferences.md 中需保留的内容并入 Bundle 的 book/overview.md 或 book/glossary.md，在覆盖审计登记实际路径；不把待核查内容伪装为可执行方法按 methodology/06-stage4-pressure-test.md，晋级能力测触发，router 能力测可达；两类都要实际完成代表任务并核对输出，不能用“会调用”替代“做得对”。缺失输出计入评测分母，未完成不得声明通过。未过的回炉重做阶段 2。
按 methodology/07-stage5-deliver.md:
books/<slug>/DIGEST.md — 面向读者的精华长文python3 scripts/cangjie.py compile --bundle books/<slug>/.cangjie/capabilities --out <目标目录> --output auto,把决策报告展示给用户轻确认（按推荐 / 改 single / 改 pack）destinations.json 中恰好一个去向（promoted_to 或 served_by）;未晋级能力必须可经来源路由入口到达description 必须明确 trigger 条件,并与来源路由入口互有近邻负例scripts/validate_skill_pack.py（格式/相对引用/frontmatter 100%）三者咬合: 本 skill 输出的评测用例遵循 darwin-skill 格式,以便产出的 skill 可直接接入 darwin 做自动进化。
まだレビューはありません。使ってみた感想をお寄せください。
概要と使いどころ
当用户困在无法改变的处境（坏关系/讨厌的同事/不如意的事）里反复内耗、问「该忍还是该走」时调用。 核心理念: 面对任何情境只有三选项——改变它/接受它/离开它; 三者都不做是痛苦之源; 接受=快速适应, 用「积极方面是什么」重释训练。 不适用于: 可以改变的处境(应先改变), 以及涉及违法/人身安全的场景。 Triggers: 接受/忍/内耗/放不下/该走该留/acceptance/let go/change-accept-leave
日本語の概要は準備中です。原文の説明を表示しています。
当用户在重大选择上纠结（换工作/买房/搬城/合伙/结婚）、列了利弊表还是拿不定主意时调用。 核心理念: 无法决定就答否; 三个重大决定(住哪/和谁/做什么)值得花一两年; 两个均等选择选短期更痛苦的路。 不适用于: 日常琐碎选择（晚饭吃什么）、信息查询。 Triggers: 纠结/拿不定主意/要不要/该不该/利弊/decision/hesitate/should I
日本語の概要は準備中です。原文の説明を表示しています。
当用户困惑「为什么有人攻击我/为什么大家卷来卷去/我怎么不在乎别人眼光/为什么妒忌」时调用。 核心理念: 人生同时存在零和地位游戏、正和财富游戏、单人游戏; 识别你玩的是哪种游戏, 避免地位游戏, 回到内在记分卡。 不适用于: 具体竞争策略制定（如何赢下某个比赛）。 Triggers: 地位/攀比/内卷/妒忌/别人怎么看我/零和/单人游戏/status game/envy
日本語の概要は準備中です。原文の説明を表示しています。
当用户问「怎么才能更幸福/为什么得到了还不满足/怎么减少焦虑」时调用。 核心理念: 幸福是缺憾感清空的默认状态, 是可训练的技能; 欲望是与自己的契约(得到前不快乐), 同时只留一个重大欲望; 活在当下。 不适用于: 临床抑郁等需要专业治疗的场景(本书方法不能替代医疗)。 Triggers: 幸福/不快乐/欲望/焦虑/知足/活在当下/happiness/desire/anxiety
日本語の概要は準備中です。原文の説明を表示しています。
当用户问怎么真诚沟通/拒绝别人/给反馈/不想说场面话、或发现自己在隐瞒时调用。 核心理念: 撒谎会先骗到自己(费曼: 你最容易愚弄的人是你); 彻底诚实=所想与所说一致; 具体表扬、一般批评; 秘密越少快乐越多。 不适用于: 需要外交辞令的谈判策略(可以诚实但不必全说)。 Triggers: 诚实/沟通/拒绝/批评/表扬/秘密/场面话/honesty/communication/feedback
日本語の概要は準備中です。原文の説明を表示しています。
当用户纠结时间分配、问「这个琐事/外包值不值」「怎么安排时间」「离财务自由还差什么」时调用。 核心理念: 给时间定一个高得离谱的时薪, 低于时薪的事外包或不做; 退休=不为想象中的明天牺牲今天; 不随收入升级生活方式。 不适用于: 需要享受慢节奏的时刻（休息/家庭时间按定义不是浪费）。 Triggers: 时薪/时间管理/外包/琐事/排队/财务自由/退休/hourly rate/delegate
日本語の概要は準備中です。原文の説明を表示しています。