skillZs
LIVE SKILL TAGS
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
REAL INSTALL DATA
← back to all skills
lijigang/ljg-skills3k installs

ljg-book

Book reader that reconstructs a book as x -> f -> f(x): the problem it addresses, the author's central answer, and how that answer changes judgment or action. USE WHEN the user gives a book title, PDF, excerpt, or asks 拆书, 分析这本书, 这本书在讲什么, 压缩一本书, or book. Defaults to a saved org note. NOT FOR chapter summaries, framework audits, papers, single-idea deep dives, or field ranking.

How do I install this agent skill?

npx skills add https://github.com/lijigang/ljg-skills --skill ljg-book
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is designed to perform structural analysis of books, extracting core arguments and frameworks. It uses standard tools like web search to gather information and shell commands for generating timestamps. The results are saved locally in the user's Documents folder. All operations are consistent with the stated purpose and do not pose a security risk.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

What does this agent skill do?

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 后,找出全书最大的理解瓶颈:哪个机制最难仅靠文字在脑中成形,但一旦看懂,其余概念会自动归位?为它选择理解成本最低的表征,而不是默认继续写 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. 把话题收成一个具体 x。
  2. 找出作者为 x 提出的主 f,而不是列全书概念。
  3. 用 2 到 4 个书内锚点说明 f 怎样成立、怎样运转。
  4. 计算 f(x):如果真的接受 f,面对 x 会改变什么。
  5. 扫描最大的理解瓶颈,用图、表或文字中成本最低的表征让它显形。
  6. 删除不能接入这条逻辑链的内容。

顶层章节固定为:

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

Examples

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

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

文学作品:《悉达多》

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

Completion

生成后读回确认:

  • 文件确实保存,frontmatter 完整。
  • 开头恰好有 x / f / f(x) 三行。
  • x 是问题,f 是回答,f(x) 是应用后的结果;三者不是并列摘要。
  • 正文四节齐全,并且每节都在补同一条逻辑链。
  • 正文至少有 2 个书内锚点,没有顺着目录做章节摘要。
  • f 说清了内部机制,没有退化成一个术语或概念清单。
  • f(x) 具体说明了理解、判断或行动的改变。
  • 正文没有来源、承重、贡献类型、挪动类型等审稿信息。
  • 已完成理解阻力扫描;最难成形的机制获得了合适表征,或确认短句已经足够。
  • ASCII 图只在真正增进理解时出现,格式与宽度合格。
  • 若核心思想依赖形状、空间或动态关系,图没有被省略;只看图即可复述作者改变的判断。
  • 资料校准只有必要来源,没有扩成研究综述。
  • 只读开头三行,就能回答:「这本书在问什么、怎样回答、回答之后怎么办?」

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/lijigang/ljg-skills/ljg-book">View ljg-book on skillZs</a>