ljg-book：读懂一本书的 x → f → f(x)

把一本书还原成一条完整的逻辑链：

• x：作者到底在处理什么问题。
• f：作者给出的核心回答是什么。它可能是一个概念、区分、框架、方法、模型或叙事视角。
• f(x)：把这个回答放回问题后，我们应当怎样重新理解、判断或行动。

目标不是把书压成一句鸡汤，也不是给作者做框架审计。读完笔记，既要知道「这本书在讲什么」，也要知道「它改变了我怎样回应这个问题」。

Workflow Routing

输入	必读	输出
书名	查到可靠材料后读 ReadingGuide.md	保存 org 笔记
PDF、正文、样章、旧笔记	先读材料，再读 ReadingGuide.md	保存 org 笔记
用户明确只要口头解释	ReadingGuide.md	不写文件，按同一路径讲

写 org 文件时再读 references/template.org。默认保存到 ~/Documents/notes/。

文件名沿用 Denote：{YYYYMMDDTHHMMSS}--拆书-{书名}__book.org；时间戳用 date +%Y%m%dT%H%M%S 生成。

Completion Target

开头先给三行极简结论：

- *x*：{作者在讨论什么问题}
- *f*：{作者用什么核心回答处理 x}
- *f(x)*：{接受 f 后，面对 x 应如何回应}

三行必须能连读：因为存在 x，作者提出 f；把 f 用在 x 上，得到 f(x)。如果三行只是三个相关观点，说明逻辑链还没接通。

正文再展开这条链。通常 900 到 1600 个汉字，不含文件头与资料校准；短书可以更短，复杂书只有在逻辑确实需要时才超过 1600 字。

字数只约束表达，不约束理解。必须先完成全书覆盖与机制筛选，再压缩成文；不能为了卡字数，删掉读者重建 f 所必需的方法步骤。

全文覆盖门

拿到全文时，定义 x 和 f 之前必须先完成一张内部覆盖图，至少检查：

1. 前言或导论：作者自述的问题、对象与方法。
2. 前部：分析对象、基本区分与最小单位怎样建立。
3. 中部：方法或机制怎样实际运转。
4. 后部与结论：方法得到什么发现、适用到哪里、边界是什么。

覆盖图不必写进成品，但不能只在脑中完成。复制 references/coverage-map.md 到本次任务的临时工作目录，填完 5 到 12 个候选部件及书内位置，再决定哪些进入主 f。若作者明确说「这是一本方法之书」，或全书大部分篇幅都在搭建分析工具，不能只把结论当作 f。

压缩顺序固定为：

全书覆盖 → 候选部件 → 因果角色 → 删除测试 → x / f / f(x) → 成文压缩

不能先凭一个醒目的结论锁定 f，再只搜索支持它的段落。

理解阻力扫描

完成 f 后，找出全书最大的理解瓶颈：哪个机制最难仅靠文字在脑中成形，但一旦看懂，其余概念会自动归位？为它选择理解成本最低的表征，而不是默认继续写 prose。

思想形状	优先表征
凸凹、分布、边际变化、空间关系	ASCII 曲线或形状图
前后步骤、因果传导、状态变化	流程图或时间轴
循环、反馈、自我强化	回路图
层级、部分与整体	结构图
两种机制反复对照	小表格
一两句话已经足够	纯文字

图不是标配；但当思想本身具有形状、空间关系或动态变化时，不能只用文字转述。图必须服务 x → f → f(x)，让读者只看图也能说出作者改变了哪个判断。

• ASCII 图放进 org 的 #+begin_example / #+end_example 块。
• 保持图形不变形，宽度不超过 80 字符。
• 一张足够；若图没有降低理解成本，删除它。

最小形态：

#+begin_example
x：原来的问题
        │
        ▼
f：作者的概念 / 框架 / 方法
        │ 应用
        ▼
f(x)：新的理解 / 判断 / 行动
#+end_example

Gotchas

• x 不是话题。 「科技与未来」不是 x；「技术演化是否有自己的方向」才是。
• f 不是标签。 只写「系统思维」「存在主义」「反脆弱」不算回答；要说明它怎样处理 x。
• f 也不是贡献类型。 不输出来源、承重、原创性、贡献类型、挪动类型等审稿判断，除非用户明确要求。
• 不要从 x 直接跳到建议。 缺少 f，笔记就会只剩泛泛的人生启示。
• 不要把 f 写成目录。 成文可以有 2 到 4 个必要部件，但这是因果角色的数量，不是候选概念的上限。先做完整候选清单，再合并同类角色。
• 不要用结论代替方法。 结论说明作者发现了什么，方法说明他怎样得到这个发现。方法型书两者缺一不可。
• 不要先压缩再补漏。 字数、单一主线和「删除无关内容」只在覆盖门通过后生效。
• f(x) 不是口号。 写清接受 f 后，原来的理解、判断顺序或行动究竟哪里改变。
• 文学作品也有 f。 它可能不是方法论，而是一个意象、人物关系或叙事运动，让某个问题被重新看见；不要硬改成效率工具。
• 研究留在后台。 作者背景、思想源流和外部争论只用于避免误读；正文只保留理解 x、f、f(x) 真正需要的部分。
• 别把「图不是标配」理解成少画图。 先找理解瓶颈；若核心思想依赖形状、空间或动态关系，漏图就是漏掉 f 的一部分。
• 不要只把摘要换行排成图。 图要让机制显形；读者只看图仍说不出判断变化，就没有解释作用。
• 材料薄就少说。 只有目录、访谈或书评时标为「初拆」；证据更薄时标为「假设版」。

Quick Reference

1. 有全文时先做覆盖图，记录 5 到 12 个候选部件。
2. 区分作者的研究问题、操作方法、所得发现与适用边界。
3. 把话题收成一个具体 x。
4. 找出作者为 x 提出的主 f，而不是列全书概念，也不是只摘结论。
5. 对候选部件做删除测试：删掉后还能否重建 f 如何得到结论？
6. 用分布在前部、中部、后部的书内锚点说明 f 怎样成立、怎样运转。
7. 方法型书用一个书内例子完整跑通方法。
8. 计算 f(x)，再扫描理解阻力并选择表征。
9. 最后才删除不能接入逻辑链的内容并压缩成文。

顶层章节固定为：

1. * x：作者在讨论什么问题
2. * f：作者怎样回答
3. * f(x)：怎样回应这个世界
4. * 资料校准

全文拆书的锚点不能都来自同一章或同一结论段；至少覆盖作者提出问题、展示机制、给出发现或边界的不同位置。

Examples

分析类书：《决策与判断》

• x：为什么同一个选择换一种表述，人会作出相反决定？
• f：前景理论用参照点、损失厌恶与非线性概率权重解释判断偏移。
• f(x)：重要选择先换一种得失表述；若答案随表述改变，暂缓决定。

文学作品：《悉达多》

• x：智慧能否像知识一样由一个人传给另一个人？
• f：教义可以指路，智慧却要在亲历、倾听与对矛盾经验的整合中生成；河流是这套回答的集中意象。
• f(x)：向别人求答案时，先分清自己缺的是可传授的知识，还是尚未亲自消化的经验。

Completion

生成后读回确认：

• 全文覆盖图已经完成；没有只靠关键词命中或结论章决定主 f。
• 作者自述的研究对象、方法与核心发现都已被检查，并明确区分。
• 文件确实保存，frontmatter 完整。
• 开头恰好有 x / f / f(x) 三行。
• x 是问题，f 是回答，f(x) 是应用后的结果；三者不是并列摘要。
• 正文四节齐全，并且每节都在补同一条逻辑链。
• 全文拆书的锚点分布在前部、中部、后部；薄材料则诚实降级。
• f 说清了内部机制，没有退化成一个术语或概念清单。
• 方法型书有一个例子从输入、操作到结果完整跑通；结论没有冒充方法。
• 对每个被删除的候选部件做过删除测试：删除后仍能说明作者怎样得到结论。
• f(x) 具体说明了理解、判断或行动的改变。
• 正文没有来源、承重、贡献类型、挪动类型等审稿信息。
• 已完成理解阻力扫描；最难成形的机制获得了合适表征，或确认短句已经足够。
• ASCII 图只在真正增进理解时出现，格式与宽度合格。
• 若核心思想依赖形状、空间或动态关系，图没有被省略；只看图即可复述作者改变的判断。
• 资料校准只有必要来源，没有扩成研究综述。
• 只读开头三行，就能回答：「这本书在问什么、怎样回答、回答之后怎么办？」

写入 Org 后运行：

bun {skill_dir}/scripts/validate_note.ts /absolute/path/to/note.org \
  --coverage /absolute/path/to/coverage-map.md

完整拆书缺少覆盖记录时，检查器必须失败。检查器通过仍不等于语义绝对完整；它负责拦住标题、三行结论、资料校准、Denote identifier、图形宽度和覆盖工序缺失等可机械验证的问题。覆盖内容是否准确，仍须对照原文逐项读回。