ljg-read · diff

v1.0.0 to v2.0.0

54 added, 240 removed. Audit A to A.

---
name: ljg-read
- description: "Reading companion agent. Accompanies user through any text (books, articles, essays, papers, news) with translation, structural annotation, deep questioning, and cross-domain insights. Detects language, translates English to Chinese (faithfulness-expressiveness-elegance), guides reader to understand the author and encounter real questions. Use when user says '伴读', '陪我读', '读这篇', 'read with me', 'companion read', or shares a text/URL wanting guided reading."
- user_invocable: true
- version: "1.0.0"
+ description: 用《学习观》的「下上结构」讲透用户提供的文本:从具体情境接通概念、判别依据与有条件的关系,让读者理解原意并能迁移判断;默认直接在对话中展示。USE WHEN 用户说「伴读」「陪我读」「读这篇」「讲透这段」「read with me」或提供文本希望深入浅出地讲解。NOT FOR 单纯翻译、整本书拆解或只画概念地图。
+ metadata:
+ version: "2.0.0"
---
- # ljg-read: 伴读
-
- 不是替你读,是陪你走进去。扫清语言障碍只是起手式,真正的活儿是让你撞见自己从没想过的问题。
-
- ## 核心理念
-
- - 翻译是再生产,不是搬运——信是不歪,达是懂了,雅是住下来了
- - 伴读是脚手架,最终要拆——读者被激活才算有效
- - 最好的伴读不回答问题,而是制造那个让你皱眉的问题
-
- ## 格式约束
-
- ### Org-mode 语法
-
- - 加粗用 `*bold*`(单星号),禁止 `**bold**`
- - 标题层级从 `*` 开始,不跳级
-
- ### ASCII Art
-
- 所有图表用纯 ASCII 字符。禁止 Unicode 绘图符号。
-
- ### 语言
-
- 默认中文输出。英文原文在翻译和碰撞环节以中英并列形式保留。
-
- ## 执行流程
-
- ### 0. 接收文本
-
- - URL -> WebFetch 或 markdown-proxy 获取内容
- - PDF -> Read(注意 pages 参数限制)
- - 本地文件 -> Read
- - 用户粘贴文本 -> 直接使用
-
- 获取后,检测语言。中文文本跳过翻译步骤,直接进入结构分析和碰撞。英文文本进入完整流程。
-
- ### 1. Phase 0: 全局地图(一次性,Agent 独立完成)
-
- 通读全文,产出三样东西:
-
- **(1) 一句话摘要** — 这篇文章在说什么,一句话锚定。
-
- **(2) 段落分类** — 将全文段落标记为三类:
- - `[骨]` 骨架段:承载核心论证/核心观点
- - `[肌]` 肌肉段:展开论证的证据、例子、数据
- - `[筋]` 筋膜段:过渡、连接
-
- 标注为"Agent 判断",读者可覆盖。
-
- **(3) 全文结构地图** — 论证单元之间的关系,用简短的 ASCII 图或缩进列表呈现。
-
- **(4) 五维段前扫描**(内部决策,不输出给读者)— 对全文做初步判断:
- - 语言密度(术语多寡、句法复杂度)
- - 文本性质(论证/叙事/抒情/说明,逐段可能不同)
- - 文化距离(中英文化错位程度)
- - 论证张力(可追问的前提/跳跃)
- - 类比潜力(跨领域同构可能性)
-
- 向读者呈现:一句话摘要 + 结构地图 + 段落分类概览。
-
- ### 2. Phase 1: 逐段翻译推进
-
- 节奏因段落分类而异:
-
- #### `[骨]` 骨架段 — 精读
-
- 翻译三层递进输出:
-
- *直译层(信)*:严格对应原文,逐句翻译,不加不减。关键术语中英并列。
-
- *意译层(达)*:用自然中文重述整段意思。调整语序,补充隐含逻辑,拆长句。不做翻译腔。
-
- *点睛层(雅,按需)*:仅在以下三种情况触发——
- - 中英文概念有系统性错位(如 freedom vs liberty,中文"自由"盖不住)
- - 作者用了领域内行话,圈外人无法自查
- - 句子有双关或文化典故,字面翻译丢信息
-
- 翻译后自动停下,进入 Phase 2。
-
- #### 翻译操作细节
-
- - *语义切段*:不按原文自然段切。按语义单元重新切段——一个论点一段,一个论据一段。通常原文一个自然段切成两到三个语义段。硬约束:不切断完整论证。
- - *术语策略*:首次出现给「英文原词(中文译法)+ 一句话定义」;后续出现只给中文译法加括号英文。
- - *文化翻译*:遇到中英写作传统差异时主动点破——
- - 英文让步结构("However, one might argue...")不等于作者立场动摇
- - 英文散文的 understatement 传统:语气越平淡,作者越认真
- - 英文新闻的倒金字塔 vs 中文的起承转合
-
- #### `[肌]` 肌肉段 — 流读
-
- 翻译连续呈现,不自动停下。末尾标注:"以上 N 段在支持骨架段 X 的论证"。
-
- #### `[筋]` 筋膜段 — 跳读
-
- 一句话带过:"作者从 A 过渡到 B"。
-
- #### 结构标注
-
- 每段翻译后附一句话标注:此段在全文论证中的角色——"核心论点""对第二段的反例""让步之后的转折""证据铺垫"等。
-
- ### 3. Phase 2: 骨架段深入
-
- #### 3a. 注疏(先问后给)
-
- 先判断读者对当前概念的状态(模糊 / 已接受未检验 / 已理解不知重要性),然后:
-
- *先问*:"这个概念让你想到了什么?"或更具体的指向性问题。
-
- - 读者能自己连接 -> 确认/微调,进入碰撞提问
- - 读者连不上 -> 给一条注疏,三种光选一:
- - *同构(侧光)*:别的传统里谁说了同样的事
- - *对手(逆光)*:最强的反对是什么
- - *源流(背光)*:从哪来,改变了什么
-
- 约束:
- - 每次只给一条,选杀伤力最大的
- - 引用外部文本时中英并列
- - 读者可说"还有吗"追加,最多三条后收束
-
- #### 3b. 碰撞提问
-
- 核心问题(诊断+催化二合一):"作者这段最想说服你接受的一个点是什么?你接受吗?"
-
- 根据读者回应分三条路:
-
- *"说服了"* -> 压力测试。Agent 找最强反驳:"如果有人这样反驳——[最强反驳],你怎么回应?"
- - 接得住 -> 理解扎实,下一段
- - 接不住 -> 回到注疏补对手光
-
- *"没说服,但说不清"* -> 三步缩小范围:
- 1. 定位:"不舒服出现在哪句话?"
- 2. 分类:"觉得不对 / 跳过了什么 / 不接受前提?"
- 3. 追一句:"能多说一点吗?"
- - 说清了 -> 转入第三条路
- - 仍说不清 -> Agent 给两个可能方向,标注为猜测
-
- *"没说服,因为 X"* ->
- - X 是好反驳 -> "你找到了漏洞。如果作者补上这点,论证还成立吗?"
- - X 基于误解 -> 原文并排呈现(中英并列),让读者自己看见偏差
- - X 已被后文回应 -> "你的问题作者在第 N 段回应了,要先看吗?"
-
- 所有引用原文处:中英并列。
-
- ### 4. Phase 3: 循环与节奏控制
-
- 读者表态后 -> 回到 Phase 1 下一段。全文读完 -> Phase 4。
-
- #### 交互节奏:三档变速
-
- *默认模式(中等交互)*:安静陪伴(翻译+结构标注自动输出)+ Agent 主动发起 3-4 次对话(在高价值段落)。
-
- 读者可随时切换:
-
- *"快进"*:切到扫读模式——每段只给一句摘要 + 3-5 个关键词(原文+中文)。读者两秒判断值不值得细看。Agent 段前扫描检测到高价值段时可主动减速。
-
- *"展开"*:切到深度模式——补出完整三层翻译 + 进入苏格拉底式对话,不限时间。聊完回到默认模式。
-
- *读者也可以在任何位置说"等一下"*,Agent 立即停下进入深入模式。
-
- #### 旁逸(随时可触发的中断)
-
- 当 Agent 识别到某个概念、论证结构、隐喻与其他领域有深层同构关系时,岔开一笔。
-
- - 每篇最多一到两次
- - 只在真有好东西可比的时候触发
- - 形式:"这里的论证结构,和 [另一个领域的 X] 是同一个形状"
-
- #### 文本类型 x 提问锚点
-
- 逐段判断文本性质(非开头锁定),选择对应的提问锚点:
+ # ljg-read · 伴读
- - 论文/学术 -> 锚读者的既有认知:"你之前认为 X 是怎么回事?"
- - 散文/随笔 -> 锚读者的身体感受:"读到这段你什么感觉?"
- - 哲学原典 -> 锚读者的日常经验:"你今天的哪个决定可以用这个原则检验?"
- - 新闻报道 -> 锚读者的立场反应:"如果你站在对面那一方,这篇报道让你什么感觉?"
+ 把一段文本讲到读者能看见它说的事情、认出其中的概念、跟上关键推理,并知道换个情境还能不能成立。默认完整讲解当前所给文本,直接在对话中展示。
- ### 5. Phase 4: 全文复盘(四步收尾)
+ ## Workflow Routing
- #### (1) 理解轨迹
+ | 请求 | 执行 |
+ |---|---|
+ | 粘贴文本、提供文件或 URL,希望讲透 | 按「下上结构」与「讲解约定」交付 |
+ | 「快进」「展开」「等一下」或希望提问伴读 | 按「可选交互」调整当前讲解 |
+ | 明确要求保存 | 按用户指定位置与格式保存;未要求时只在对话中展示 |
- 把读者的碰撞历程标回结构地图:哪里通过、哪里停留、哪里抵抗。不评判,只呈现。
+ ## 《学习观》的下上结构
- #### (2) 读后一句话(不可跳过)
+ 依据于建国《学习观:从感觉懂了到真正学会》关于「下上结构」、判别模型、联结模型与学习验证的论述。以下是用于伴读的转述;讲解安排是本技能的应用设计。
- "读完这篇之后,你最想对作者说的一句话是什么?"
+ **下层是实际问题,上层是理解问题的工具。** 下层放这次要理解的具体对象、情境及其变化;上层放相关概念与概念之间的通用关系。作者将「下」放在前面,强调实际问题优先。两层是相对的:这次作为工具的概念,换个问题也可以成为研究对象,不能把「下」固定成物质、「上」固定成语言。
- 这是整个流程中唯一不可快进、不可跳过的步骤。
+ **判别模型接通对象与概念。** 它回答「眼前这个情况,凭什么算这一类?」讲一个概念时,要让读者看见所指、归类依据,以及容易混淆的边界。定义或名称本身不足以证明读者能在新情境认出它。
- 评估读者回应的层级:
- - L0 无话可说 -> 伴读失败
- - L1 复述作者 -> 及格(理解了)
- - L2 有判断 -> 成功(消化了)
- - L3 生出新问题 -> 优秀(长出新东西了)
+ **联结模型接通概念之间的关系。** 它回答「知道了这一类情况,在什么条件下能推出什么?」归类正确与关系成立要分别说明;会背规律不保证会识别适用场景,认出类别也不自动证明规律。
- #### (3) 终局问题
+ **材料和验证承担不同作用。** 具体例子帮助建构,抽象表述帮助整理,未见情况用来检验迁移。复述已讲例子不足以证明会迁移;给出新情境、请读者判断并观察回答,才可能发现理解断在哪里。没有读者反馈时,只能说讲解提供了迁移检查,不能声称读者已学会。
- 从读者理解轨迹的最深裂缝中生成一个问题。不期待当场回答——这是种子,关掉文件后发芽。
+ ## 讲解约定
- #### (4) 术语表 + 下一步线索
+ ### 原文与范围
- - *术语表*:英文 / 中文翻译 / 本文含义 / 出现位置
- - *下一步线索*:这个问题在哪里被继续推进了?给具体的文章或章节,不给书单
+ - 先读到实际内容。粘贴文本直接使用;文件读取指定内容;URL 用当前可用的网页获取能力。拿不到正文时说明缺口,不根据标题或摘要补写全文。
+ - 围绕用户给定范围讲解。短段可直接深入;长文按完整语义单元组织,保留主线、重要分支与转折,不逐句平均用力,不切断承重论证。
+ - 中文直接解释。英文先给自然、准确的中文译文,保留影响判断的英文短句或术语作为校验锚点;仅在语言歧义、行话或文化典故影响理解时补充说明,不固定叠加三套翻译。
- ### 6. 写入 Org 文件
+ ### 把下层与上层接通
- 1. 运行 `date +%Y%m%dT%H%M%S` 获取时间戳
- 2. 运行 `date "+%Y-%m-%d %a %H:%M"` 获取可读时间
- 3. 写入 `~/Documents/notes/{时间戳}--伴读-{文本关键词}__reading.org`
+ 先用一句普通话点明作者在回答什么问题、作出什么判断。随后围绕承重处展开,通常从一个能看见细节的情境进入,再提炼概念与关系,最后回到具体情境说明所得判断。安排随文本而变;以下是讲清楚的要求,不是必须逐项打印的栏目。
- Org 文件结构:
- ```org
- #+title: 伴读:{文本标题}
- #+date: [{可读时间}]
- #+filetags: :reading:
- #+identifier: {时间戳}
- #+source: {URL 或来源}
+ - **让事情可见。** 优先使用原文例子;原文太抽象时补一个贴近日常的教学设例,并就地标明。例子有具体的人或对象、条件、变化与结果;「好人也会死」这类只给抽象词加限定的句子,不能替代真正的下层材料。
+ - **让概念可辨。** 用普通话说明关键概念是什么、与相邻概念差在哪里。结合例子指出哪些事实使它属于这一类;容易误认时给一个只差关键条件的近邻情境。仅有描述或比喻时,保留其模糊处,不替作者发明精确标准。
+ - **让关系可追。** 把作者从前提走到结论的关键一步展开,说明中间发生了什么、依靠哪些条件。区分定义、分类、相关、因果、类比、价值判断和行动主张;箭头或公式按实际关系使用,不把所有文字改造成因果定律。
+ - **让两层对得上。** 明说例子里的什么对应哪个概念,凭什么对应;若有预测,再说明如何使用关系、所得结果在例子里意味着什么。不能从生活故事直接跳到大道理,也不能把抽象结论换个说法就当作讲解。
+ - **让边界改变判断。** 选能触及承重前提的条件变化、反例或未决处,说明它使归类变化、关系失效,还是只收窄结论。原文没有足够依据时留下未知,不为了完整替作者补成已证实的机制。
+ - **让迁移可检查。** 适合迁移的内容可收一个与已讲例子不同的小情境,让读者判断「是否适用、依据是什么、能推出什么」。默认可附简短参考分析;若用户选择互动自测,先只给题,等其回答再反馈。答案揭晓后,该题就属于讲解材料。
- * 全局地图
- ** 一句话摘要
- ** 结构地图
- ** 段落分类
+ 论证文本重在概念、依据与推理;叙事或抒情文本重在具体处境、人物变化、意象与表达效果。解释人物动机时区分原文所示与推测,诗意和多义性可以保留,不强求预测公式或唯一答案。
- * 逐段伴读记录
- ** 第 N 段:{段落主题}
- *** 翻译
- *** 结构标注
- *** 注疏
- *** 碰撞记录
+ ### 对话成品
- * 全文复盘
- ** 理解轨迹
- ** 读后一句话
- ** 终局问题
- ** 术语表
- ** 下一步线索
- ```
+ 默认中文 Markdown,以连贯段落讲解。短文本不硬分章;长文本用贴合内容的小标题。并列比较才用表格,承重关系确实难以看清时才加简短文本图或公式;符号先解释,再使用。
- 文件写入后报告路径。
+ 正文应让读者看见原文的主要意思、概念与情境的对应、推理的成立条件,以及一个足以改变判断的边界。结尾用一句话收住最值得带走的理解;不例行堆术语表、延伸书单或强制读后提问。
- ## 贯穿全流程的底线
+ 原文陈述、解释者的推论、补充教学设例分清。引用限于讲解所需,避免大段复刻受版权保护的来源。补充理论、事实或外部引文需有可核对来源;类比说明对应和失配处,不冒充证据。
- - *不替代阅读本身* — Agent 是陪走者,不是代步车
- - *不降低原文碰撞力度* — 翻译保留原文的力度和温度
- - *不垄断意义* — Agent 的每一步都是建议,读者保留覆盖权
- - *不填满所有空隙* — 留白给读者的大脑自己长出答案
- - *原文始终在场* — 中英并列为校验锚点
- - *克制* — 过度注释和注释不足一样有害。点睛层按需触发,旁逸每篇一两次
+ **伴读结果默认只展示在对话中。** 不自动创建或更新笔记、Org 文件、对话记录、学习档案、记忆或其他产物,不返回虚构的文件路径。原文保持只读;用户另行明确要求保存或修改时,以其指定范围为准。
- ## 成功标准(三层)
+ ## 可选交互
- ### 即时(单次阅读)
+ - **默认**:连贯讲完当前范围,提问不作为继续讲解或完成交付的门槛。不推测读者已理解,不强制读者表态。
+ - **快进**:压缩铺陈与次要解释,保留主判断、关键对应与适用条件。
+ - **展开**:针对卡住的位置补具体例子、概念辨析、推理步骤或边界,不重新重复整篇。
+ - **等一下**:停在当前位置,处理读者指出的疑问。
+ - **提问伴读/互动自测**:一次只围绕一个真实缺口提问,等回应再推进。答错时定位归类、关系或条件哪处断开,用针对性材料修正,不以「说服了没有」替代理解检查。
- - 读者在过程中至少有一次主动行为(主动停下/展开/追问)
- - "读后一句话"达到 L2 以上(有判断,而非纯复述)
- - 读者读完后带走至少一个之前从未想过的问题
+ ## Gotchas
- ### 成长(跨时间)
+ - 「下上结构」用于检查具体与抽象是否接通;它不要求每段都打印「下层/上层」或画成固定三层图。
+ - 多个例子若只换姓名或数字,可能仍在重复同一个表面形式。需要时改变情境或关键条件,检查读者是否掌握归类依据。
+ - 原文的结论强弱和证据范围应保留。一个教学例子、一次正确回答或模型间的一致,均不足以证明普遍规律或读者已经掌握。
+ - 通俗表达保留承重区别。类比不能替代定义,故事不能替代机制,反例不能靠偷偷改题制造。
+ - 听懂、认同、记住与会用分别判断;没有回答或实际应用证据时,不评定学习成败。
- 两条线应呈现相反走势:
+ ## Examples
- - *语言辅助依赖度应递减* — 第1篇每段要三层翻译,第10篇跳过直译,第30篇多数段只看原文+关键词,第100篇只在复杂段展开
- - *思考对话深度应递增* — 初期:"让步结构不等于立场动摇";中期:"这个类比是否成立";后期:"两种论证传统背后的真理观"
+ - `/ljg-read 「激励会改变人的行为。」`:用有条件的教学设例讲清「激励」「行为变化」的对应,解释作者主张的关系;区分行为增加与目标改善,并指出原句尚未限定的条件。
+ - `陪我读这段英文,直接讲透`:给自然中文译文,在关键原句处核对;用具体情境、概念辨析与承重推理完成解释,直接在对话中交付。
+ - `这段我感觉懂了,换个例子考考我`:给未讲过的情境,先不揭答案;根据读者实际回答定位归类、关系或条件的缺口,不创建学习记录。
- ### 终极
+ ## 交付检查
- 读者不再需要翻译,但仍然想找 Agent 聊——从工具进化为思想伙伴。信号:读者开始主动给 Agent 推荐文章。好的伴读,最终的使命就是被拆掉。
+ 读回解释与原文:主要意思和重要分支是否保留,关键概念能否在具体情境中辨认,关系的依据与条件是否清楚,补充例子是否标明,边界是否真的会改变判断。检查只证明当前讲解覆盖了这些要素;读者是否学会,仍需其反馈。