Tooluck logoTooluck
SKILL.md

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)

skills/ljg-read/SKILL.md

MITFull file
1# ljg-read · 伴读
2
3把一段文本讲到读者能看见它说的事情、认出其中的概念、跟上关键推理,并知道换个情境还能不能成立。默认完整讲解当前所给文本,直接在对话中展示。
4
5## Workflow Routing
6
7| 请求 | 执行 |
8|---|---|
9| 粘贴文本、提供文件或 URL,希望讲透 | 按「下上结构」与「讲解约定」交付 |
10| 「快进」「展开」「等一下」或希望提问伴读 | 按「可选交互」调整当前讲解 |
11| 明确要求保存 | 按用户指定位置与格式保存;未要求时只在对话中展示 |
12
13## 《学习观》的下上结构
14
15依据于建国《学习观:从感觉懂了到真正学会》关于「下上结构」、判别模型、联结模型与学习验证的论述。以下是用于伴读的转述;讲解安排是本技能的应用设计。
16
17**下层是实际问题,上层是理解问题的工具。** 下层放这次要理解的具体对象、情境及其变化;上层放相关概念与概念之间的通用关系。作者将「下」放在前面,强调实际问题优先。两层是相对的:这次作为工具的概念,换个问题也可以成为研究对象,不能把「下」固定成物质、「上」固定成语言。
18
19**判别模型接通对象与概念。** 它回答「眼前这个情况,凭什么算这一类?」讲一个概念时,要让读者看见所指、归类依据,以及容易混淆的边界。定义或名称本身不足以证明读者能在新情境认出它。
20
21**联结模型接通概念之间的关系。** 它回答「知道了这一类情况,在什么条件下能推出什么?」归类正确与关系成立要分别说明;会背规律不保证会识别适用场景,认出类别也不自动证明规律。
22
23**材料和验证承担不同作用。** 具体例子帮助建构,抽象表述帮助整理,未见情况用来检验迁移。复述已讲例子不足以证明会迁移;给出新情境、请读者判断并观察回答,才可能发现理解断在哪里。没有读者反馈时,只能说讲解提供了迁移检查,不能声称读者已学会。
24
25## 讲解约定
26
27### 原文与范围
28
29- 先读到实际内容。粘贴文本直接使用;文件读取指定内容;URL 用当前可用的网页获取能力。拿不到正文时说明缺口,不根据标题或摘要补写全文。
30- 围绕用户给定范围讲解。短段可直接深入;长文按完整语义单元组织,保留主线、重要分支与转折,不逐句平均用力,不切断承重论证。
31- 中文直接解释。英文先给自然、准确的中文译文,保留影响判断的英文短句或术语作为校验锚点;仅在语言歧义、行话或文化典故影响理解时补充说明,不固定叠加三套翻译。
32
33### 把下层与上层接通
34
35先用一句普通话点明作者在回答什么问题、作出什么判断。随后围绕承重处展开,通常从一个能看见细节的情境进入,再提炼概念与关系,最后回到具体情境说明所得判断。安排随文本而变;以下是讲清楚的要求,不是必须逐项打印的栏目。
36
37- **让事情可见。** 优先使用原文例子;原文太抽象时补一个贴近日常的教学设例,并就地标明。例子有具体的人或对象、条件、变化与结果;「好人也会死」这类只给抽象词加限定的句子,不能替代真正的下层材料。
38- **让概念可辨。** 用普通话说明关键概念是什么、与相邻概念差在哪里。结合例子指出哪些事实使它属于这一类;容易误认时给一个只差关键条件的近邻情境。仅有描述或比喻时,保留其模糊处,不替作者发明精确标准。
39- **让关系可追。** 把作者从前提走到结论的关键一步展开,说明中间发生了什么、依靠哪些条件。区分定义、分类、相关、因果、类比、价值判断和行动主张;箭头或公式按实际关系使用,不把所有文字改造成因果定律。
40…

Excerpt shown under the repository's MIT license.

More skills in ljg-skills

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates