All skills
lijigang avatar

/ljg-card

@656b148
by lijiganglijigang/ljg-skills7.4k stars
845

Content caster (铸). Transforms text into PNG through precise HTML typography and, when the mold needs it, generated raster imagery. Four molds: -l (default) long reading card, -f source-faithful full text, -c comic, -w whiteboard. USE WHEN user says '铸', 'cast', '做成图', '做成卡片', '做成海报', '原文排版', '全文卡片', '漫画', or '白板'.

Use this Skill: https://skilld.dev/gh/lijigang/ljg-skills/ljg-card

This session only. Nothing lands on disk.

referenceslearning-design.md

≈1.7k tokens on demand. Your agent reads this file only when SKILL.md points to it.

知识讲解:把对象、概念与结果接起来

供 -l、-w 的知识讲解使用。目标是让读者面对新情形时知道怎样判别、何时应用、能推出什么。文学、叙事与审美表达不强加这套路线,-f 不补写任何教学材料。

借用《学习观》的下上结构:下层是本次要处理的具体对象与问题,上层是可以指导它的概念和有条件的关系。层级相对;对象可以是物件、一次行为、一段文字或一个数学对象。版面上下、先讲例子还是先讲规则,都由阅读需要决定。

连接要写在实际解释里

读者应能从同一段解释中指出:眼前是什么对象,发生了什么动作或状态变化,哪个特征支持归类,关系靠什么条件成立,最后得到什么结果。概念名负责收拢已经可见的共同关系;正文负责让人认出这条关系。对陌生概念,可以从事情讲到命名,也可以先给判断再展开对应,顺序服从理解。

用普通话展开承重句。「需求被聚合」可以展开成「顾客先向助手说要买什么,助手再把订单交给某家店」;「限流」可以在需要处补明「短时间内不能读取太多内容」。保留有用的术语,让动作、条件和结果承担解释,避免用另一个抽象词解释前一个抽象词。

一个案例可以沿同一目标继续,也可以换成更便于判别的对象;每次换场景都交代保留了哪条关系。读者能复述故事后,还应知道下次凭什么把另一件事认作同类。必要的实例、过渡与推导可以展开,长图允许增高,不为显得简练删掉理解所需的连接。

先定读者任务,再选材料

在制作记录中用一句话写清:「目标读者面对什么新情形,应能认出什么、依据什么、推出什么?」避免只写「理解某概念」。按读者已有知识选择真正需要解释的连接,不给每个熟词补定义。

围绕核心任务检查以下材料,已有内容直接复用,不要求另建固定表格或新账本:

要素 需要回答的具体问题
对象与问题 已知什么,要求判断或推测什么?
判别依据 这个对象为什么属于该概念?容易误认的相似对象差在哪里?
关系与条件 从哪些输入可以推出什么,依赖哪些条件?
实例与结果 同一个案例里,输入怎样经过规则得到输出?结果是观察、推导还是假设?
换案与反馈 换一个对象或关键条件,读者应怎样判断?哪些依据会让原答案改变?

这里只要求覆盖会改变理解的要素,不规定例子数量、节点数量或每个概念一套习题。归类依据和适用条件就近解释,成品不另设尾部的阅读提示或边界框。

来源与补充的边界

  • 优先用原文实例、对比、反例和证据。压缩时同时考虑论证承重与学习承重。
  • 图里的具体物件可能只是类比。类比要说明哪些关系对应、在哪些地方不能照搬;不能冒充目标领域实例或实证。
  • 原文缺少判别依据、实例或验证办法时,在制作记录和交付回复中明确缺口。制卡请求本身不等于授权添加事实;用户明确要求教学改编或补例时,可以加入可核对的推导或标明的假设例,不改源文件。「通俗重写」「按下上结构重新解释」属于教学改编,补充仍不冒充原文或现实观察。
  • 补例可见标注「补充假设例」或「补充推导」,并与作者陈述分清;不给它伪造原文段落、观察结果或引用。假设案例的结果服从已声明条件,不反过来证明现实规律。
  • 来源只支持倾向、相关性或局部结论时,卡片保持原强度。未观察的结果不能写成事实。

两种模具怎样承载

-l 在连续场景中穿插判别依据和关系,讲解阶段保持同案连续;收尾可以换案,保留关键关系或只改变一个决定条件。总判断可以提前出现,不能只靠末尾金句宣称可迁移。

-w 保留纵向论证主干,在首次出现陌生概念、容易误判或条件改变的位置,局部接通对象与规则。学习材料归入所属步骤,保留真实来源;不为每个例子制造一个独立推理节点,也不把它自动升为证据。

两个模板都提供可选的 .learning-material / .learning-label,以及 .transfer-check / .transfer-feedback。标签写读者需要知道的身份或动作,如「原文实例」「凭什么归类」「换个情形」「补充假设例」,不用把制作字段名搬上卡片。关键判别使用主要字号,允许增高,不挤进小字脚注。

静态 PNG 的试用题先给情形与问题,反馈放到后续独立区域,提示先判断再下滑。它无法强制遮住答案,也无法收集读者行为;要声称学习效果,需要实际的新情形作答记录。

条件变化可能改变关系是否适用、作用强弱或结果归属。反馈指出变了哪个条件、为什么影响原判断;原关系还有部分作用时,保留它,避免把变化硬写成全有或全无。

四组同文对照

以下均为自拟教学材料,用来校准取舍,不规定未来卡片的题材或结构。

1. 隐喻清楚,判别仍然缺失

材料:一次结果只有被用于调整下一轮行动,才在这项任务中形成反馈。

失败片段:「反馈让系统进步」,配一只手拧阀门。读者看见了调整,却无法判断收藏报表算不算反馈。

修复片段:编辑看到上一期读者集中误解一个术语,于是在下一期加上具体例子;相邻对比是把同一份报表收藏后照旧写作。判别依据是结果是否进入下一轮调整,不能仅凭「看过数据」归类。阀门可以保留为类比,但这两个任务情形承担概念辨认。

2. 证明没断,学习入口被删

材料:在直角三角形中,斜边平方等于两条直角边平方之和。竖直旗杆的顶端连着一条绷直的 13 米拉绳,地面平坦,绳脚距杆脚 5 米。

失败片段:只留公式与「旗杆高 12 米」,以「只是例子」删掉垂直、绷直及边的对应。

修复片段:旗杆与地面垂直形成直角;绷直拉绳对应斜边 c=13,水平距离对应直角边 b=5;高度 a=√(13²−5²)=12 米。这里的判别说明即使不参与定理证明,也承担从场景进入公式的工作。把条件换成斜坡,先重新判断夹角,不能直接套同一计算。

3. 能重复原答,尚不能检验迁移

材料:上述旗杆示例已经讲解完成。

失败检验:把 13 米改为另一数字,让读者照抄根号计算;或问「请复述勾股定理」。两者都没有检验对象归类与条件识别。

修复检验:改为一把靠在竖直墙面、置于水平地面的 10 米直梯,梯脚距墙 6 米;要求指出哪条是斜边、是否满足条件、顶端离地多高。反馈应包含梯子对应斜边、墙与地面垂直以及 8 米的推导。再问地面倾斜时能否原样套用,答案应指出直角条件需重查。这个小检查只覆盖这些辨认与推演,不能宣称普遍掌握。

4. 有案例、有术语,读者仍看不见关系

材料:假设顾客让一个助手买齐食材,允许它比较店家、挑一家下单。若许多顾客都通过这个助手购物,商家会争取被它选中;如果助手只给链接,最终选店和下单由顾客完成。

失败片段:「助手聚合需求,商家退到执行端,入口控制权提升。」读者见过买菜,却仍不清楚三句话各自指谁、发生了什么。

修复片段:「你一直向助手说要买什么,助手挑一家店下单。店家收到它转来的订单;想接到这些顾客的生意,就得争取被它选中。顾客先找这个助手,再由它把需求带给商家,这时可以看见『聚合』这条关系。」具体对应是顾客提出需求、助手影响选店、商家承接订单;许多需求经过同一助手,是商家开始依赖它的条件。

条件对比:「现在助手只给你三家店的链接。它仍会影响你看见哪些店,最后选哪家、由谁下单,却留在你手里。」这检验控制程度怎样随条件变化,不能把「没有代选下单」写成「完全没有影响」。

验收在交付回复中报告

下列事项属于制作与交付过程,不进入卡片正文,也不追加在结尾。成品在内容自身的收束处结束,只保留署名与来源。

  1. 来源与渲染:使用现有账本、截图与像素检查,核对忠实度、结构和可读性。
  2. 内容审阅:看实际文字与画面,检查判别依据、输入输出对应、适用条件、材料身份以及换案能否暴露误用。遮住概念名,解释仍应保留支持关键判断的对象、动作或状态、条件和结果;放回概念名时,能指出这些材料与概念逐一对应在哪里。填写字段不等于满足这些要求。
  3. 读者实测:在未用于讲解的情形中取得独立作答,检查依据和结果;没有这一步就报告「未做读者实测」。模型自审或模拟回答只能提供内容问题线索。

来源材料不足时,报告具体缺口;任务仍可交付忠实的内容卡,但不能称教学材料完整。练习不是所有卡片的必填栏目,是否需要它服从用户目的和来源边界。

用户反馈「难读」「不够通俗」时,把原实际表达与重写片段对照,检查哪条连接原先缺失、补后能支持什么判断。修改同一材料与更换题材的试写分别提供证据;规则文字、结构检查、模型试写和读者反馈各自只证明相应范围。

Source: SKILL.md on GitHub

1 warningtoday5 checks · Risk SAFE
  • Gen Agent Trust Hubtoday

    The skill facilitates content rendering and image capture using Playwright and Bun. It contains a significant capability surface, including command execution and browser automation, which introduces a potential for indirect prompt injection from processed text or URLs. Additionally, an internal audit script uses character code escaping for specific filter tokens.

  • Sockettoday

    No alerts

  • Snyktoday

    Risk: MEDIUM · 1 issue

  • Runlayer6mo

    11 files scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 656b148. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 14 hours ago.

Activeupdated 2 days ago
user_invocable
true
version
7.4.1

README badge

README badge for lijigang/ljg-skills/ljg-card