ljg-read
Agent skill fromlijigang/ljg-skills
用《学习观》的「下上结构」讲透用户提供的文本:从具体情境接通概念、判别依据与有条件的关系,让读者理解原意并能迁移判断;默认直接在对话中展示。USE WHEN 用户说「伴读」「陪我读」「读这篇」「讲透这段」「read with me」或提供文本希望深入浅出地讲解。NOT FOR 单纯翻译、整本书拆解或只画概念地图。
How to install ljg-read
install ljg-read
# install the ljg-skills pack with the skills CLI
npx skills add lijigang/ljg-skills# or add only this skill to Claude Code: copy the folder
skills/ljg-read/
# into
~/.claude/skills/ljg-read/ (all projects)
.claude/skills/ljg-read/ (one project)
1# ljg-read · 伴读23把一段文本讲到读者能看见它说的事情、认出其中的概念、跟上关键推理,并知道换个情境还能不能成立。默认完整讲解当前所给文本,直接在对话中展示。45## Workflow Routing67| 请求 | 执行 |8|---|---|9| 粘贴文本、提供文件或 URL,希望讲透 | 按「下上结构」与「讲解约定」交付 |10| 「快进」「展开」「等一下」或希望提问伴读 | 按「可选交互」调整当前讲解 |11| 明确要求保存 | 按用户指定位置与格式保存;未要求时只在对话中展示 |1213## 《学习观》的下上结构1415依据于建国《学习观:从感觉懂了到真正学会》关于「下上结构」、判别模型、联结模型与学习验证的论述。以下是用于伴读的转述;讲解安排是本技能的应用设计。1617**下层是实际问题,上层是理解问题的工具。** 下层放这次要理解的具体对象、情境及其变化;上层放相关概念与概念之间的通用关系。作者将「下」放在前面,强调实际问题优先。两层是相对的:这次作为工具的概念,换个问题也可以成为研究对象,不能把「下」固定成物质、「上」固定成语言。1819**判别模型接通对象与概念。** 它回答「眼前这个情况,凭什么算这一类?」讲一个概念时,要让读者看见所指、归类依据,以及容易混淆的边界。定义或名称本身不足以证明读者能在新情境认出它。2021**联结模型接通概念之间的关系。** 它回答「知道了这一类情况,在什么条件下能推出什么?」归类正确与关系成立要分别说明;会背规律不保证会识别适用场景,认出类别也不自动证明规律。2223**材料和验证承担不同作用。** 具体例子帮助建构,抽象表述帮助整理,未见情况用来检验迁移。复述已讲例子不足以证明会迁移;给出新情境、请读者判断并观察回答,才可能发现理解断在哪里。没有读者反馈时,只能说讲解提供了迁移检查,不能声称读者已学会。2425## 讲解约定2627### 原文与范围2829- 先读到实际内容。粘贴文本直接使用;文件读取指定内容;URL 用当前可用的网页获取能力。拿不到正文时说明缺口,不根据标题或摘要补写全文。30- 围绕用户给定范围讲解。短段可直接深入;长文按完整语义单元组织,保留主线、重要分支与转折,不逐句平均用力,不切断承重论证。31- 中文直接解释。英文先给自然、准确的中文译文,保留影响判断的英文短句或术语作为校验锚点;仅在语言歧义、行话或文化典故影响理解时补充说明,不固定叠加三套翻译。3233### 把下层与上层接通3435先用一句普通话点明作者在回答什么问题、作出什么判断。随后围绕承重处展开,通常从一个能看见细节的情境进入,再提炼概念与关系,最后回到具体情境说明所得判断。安排随文本而变;以下是讲清楚的要求,不是必须逐项打印的栏目。3637- **让事情可见。** 优先使用原文例子;原文太抽象时补一个贴近日常的教学设例,并就地标明。例子有具体的人或对象、条件、变化与结果;「好人也会死」这类只给抽象词加限定的句子,不能替代真正的下层材料。38- **让概念可辨。** 用普通话说明关键概念是什么、与相邻概念差在哪里。结合例子指出哪些事实使它属于这一类;容易误认时给一个只差关键条件的近邻情境。仅有描述或比喻时,保留其模糊处,不替作者发明精确标准。39- **让关系可追。** 把作者从前提走到结论的关键一步展开,说明中间发生了什么、依靠哪些条件。区分定义、分类、相关、因果、类比、价值判断和行动主张;箭头或公式按实际关系使用,不把所有文字改造成因果定律。40…
Excerpt shown under the repository's MIT license.
