基础工具与工作流 · lijigang/ljg-skills

ljg-card

"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 '白板'."

风险提醒:蓝色 · 知晓即可AI 侦查报告
作者 lijigangGitHub lijigang/ljg-skills ↗许可 MIT(仓库根 LICENSE)commit 9e75497a95
agent 宿主通常会约束 skill 执行权限;风险提醒为 AI 侦查观点,不构成质量或安全保证。第三方 skill 仅作拆解与展示,安装使用风险自负,版权归原作者。

1实现原理 · 为什么它能做到

参数决定四种模具:-l 长图(默认)/-f 全文/-c 漫画/-w 白板,各有尺寸与图像角色;未给参数时用 -l。

skills/ljg-card/SKILL.md
| `-l`(默认) | 长图 · 静线叙事 | 1080 × auto | 0–3 幅;有理解增益时用 1 个安静主场景,必要时追加连续视觉拍点 |
注:这里在做什么:用一张参数表把模具、尺寸与生成图预算绑在一起,是后续所有步骤的分叉点。

十步共同生产线:读输入→锁定来源与事实边界→(知识讲解先定读者任务)→生成校准图→落盘核图→文字归 HTML→读模板替占位符→等字体图片→整图与切片检查→内容审阅。

skills/ljg-card/SKILL.md
6. 将所有可读文字、数字、公式、标签、箭头和来源放入 HTML/CSS;图片承担具体场景、机制动作、条件对比或明确标明的类比。
注:这里在做什么:规定图与文字的分工:凡有语义的文字、数字、箭头都由 HTML/CSS 写准,图片只画可见动作。

临时目录约束:无论从哪个目录启动,制卡前必须在 /tmp 建本任务独占目录,所有中间产物只能写入该目录。

skills/ljg-card/SKILL.md
无论从哪个目录启动,制卡前都必须在 `/tmp` 下建立本任务独占的临时目录。…全部只能写入该目录。
注:这里在做什么:用临时目录隔离候选图、渲染输入、QA 切片与日志,避免污染仓库与用户目录。

截图由自带 capture.ts(Playwright)完成,脚本会等待字体与本地图片加载,不得绕过其加载门禁。

skills/ljg-card/SKILL.md
截图脚本会等待字体与本地图片。不要绕过它的加载门禁。
注:这里在做什么:把「字体与图片就绪」做成截图前置条件,任一图片损坏即停止。

-f 全文模式走有序原文块账本与 verify-full-text.ts:改单字、调序、漏块、重复块四类反例都必须让校验工具退出非 0。

skills/ljg-card/references/mode-full.md
验收反例固定为四类:改单字、调序、漏块、重复块。四类中的任意一种都必须让校验工具退出非 0。
注:这里在做什么:把「原文一字不改」从肉眼印象变成可执行的校验器合同。

-f 字体优先使用本机 KingHwa_OldSong,禁止为制卡联网下载、临时安装或远程引用;缺失时由本地默认字体栈接管。

skills/ljg-card/SKILL.md
不得为了制卡联网下载、临时安装或远程引用该字体。
注:这里在做什么:字体策略坚持本地优先、缺失即回退,不引入远程字体依赖。

生成图先建视觉母题表与系列圣经,配统一负向约束(禁图内可读文字/Logo/水印),同系列保持角色、媒介与色彩连续。

skills/ljg-card/references/image-generation.md
写提示词前先完成表格;一行对应一个候选资产:
注:这里在做什么:把「画面该画什么」先落成表格,避免直接让图片模型猜整篇文章。

-w 白板先建论证账本:每个源章节必须映射到步骤或登记具体省略理由;账本的 source_sections 与独立来源清单 ID、顺序完全一致。

skills/ljg-card/references/mode-whiteboard.md
每个源章节必须二选一,不能静默消失。
注:这里在做什么:用独立生成的来源清单约束账本,防止漏掉原文再靠账本自证。

知识讲解(-l/-w)用 learning-design 的下上结构:读者要能从解释中指出对象、动作或状态变化、归类特征、关系条件与结果。

skills/ljg-card/references/learning-design.md
读者应能从同一段解释中指出:眼前是什么对象,发生了什么动作或状态变化,哪个特征支持归类,关系靠什么条件成立,最后得到什么结果。
注:这里在做什么:给出内容审阅的具体判据,而非只检查字段是否填满。

维护自检三命令:audit 查共享协议/四路引用/白板来源对账/全文忠实度与禁用项,test 跑纯函数与反例,fixtures 生成代表 HTML 并实际截图读回 PNG。

skills/ljg-card/SKILL.md
第一条检查共享协议、四路引用、位图槽、白板来源对账、全文忠实度合同与禁用项;第二条运行纯函数与反例测试;第三条在 `/tmp/ljg-card-v7-fixtures/` 生成代表 HTML,运行全文与白板来源校验,随后用 `capture.ts` 实际截图并读回 PNG。
注:这里在做什么:把模板与模式升级后的回归固化成三条可复跑的自检命令。

2核心能力

01把文本铸成 1080px 长 PNG 卡片(默认 -l 暖纸静线叙事长图)
02-f 原文保真全文排版:可见字句逐块只出现一次,字符与顺序不变,只用字号/字重/留白做编辑设计
03-c 漫画:格数由认知因果拍点决定,短内容不凑格、长内容不删承重关系
04-w 白板纵向论证:单条 .reasoning-spine 主干,chain/branch/timeline/matrix/radial 降为局部工具
05共享图像生成协议:资产身份四分(generated/source/brand/structural)、视觉母题表、系列圣经、提示词骨架、统一负向约束、先样图后批量
06知识讲解下上结构:按读者任务选材料,覆盖对象与问题、判别依据、关系与条件、实例与结果、换案与反馈
07自带 Playwright 截图器 capture.ts,支持指定宽高与 fullpage 长图,并可附带白板来源清单门禁
08维护工具链:audit.ts(协议与忠实度审计)、verify-full-text.ts(全文校验)、prepare-whiteboard-source.ts(来源清单)、build-fixtures.ts(fixture 回归)
09共同品味底线:判断先于装饰、每图必答「让读者看见什么」、版式不平均、收尾停在内容自身

3外部依赖

类型依赖
packageplaywright
host-tool运行时 image generation 工具
networkGoogle Fonts(comic_template.html 的 @import,产物期远程字体)

4风险提醒 风险提醒:蓝色 · 知晓即可

风险提醒:蓝色 · 知晓即可
  • 链路重、运行依赖 Bun + Playwright 与运行时 image generation 工具,环境缺失会直接阻断(-c 无图无法交付)。
  • comic_template.html 保留 Google Fonts @import,在断网或隐私要求高的环境会触发远程请求或字体回退,与 -f 明确禁远程字体的精神不一致。
  • 长图校验与人工内容审阅成本高,依赖使用者自觉执行切片检查与读者实测;静态 PNG 无法保证学习效果。
风险提醒:蓝色,仅本地脚本与本地读写,可放心使用。判级对象=本 skill 目录(skills/ljg-card/:SKILL.md + 7 references + assets 脚本/模板 + 锁文件)。逐项核实:脚本执行面全为本地 Bun/Playwright(capture/audit/verify-full-text/prepare-whiteboard-source/build-fixtures),写盘集中在独占 /tmp 与最终交付 PNG,零凭证读取。扫描命中的 URL 中,npmjs registry 仅出现在 lockfile,Google Fonts @import 仅存在于 comic_template.html 模板,都属产物期/安装期引用而非 skill 代码的网络请求,故不改档位。image_gen 属运行时宿主能力,其对用户素材的处理由宿主约束;判级只针对本目录自有行为。

5第二遍独立确认

  • [ok] 四模具与 mode/模板路由表 — SKILL.md 参数表与 mode 路由表一致(-l/-f/-c/-w 分别对应 long/full/comic/whiteboard 模板)。
  • [ok] -f 全文保真与校验器合同 — mode-full.md 规定四类反例必须让 verify-full-text.ts 退出非 0,与 SKILL.md Gotchas 互相印证。
  • [ok] -w 来源清单先于账本生成 — mode-whiteboard.md 明确 prepare-whiteboard-source.ts 由本次输入生成,账本 source_sections 必须与其 ID/顺序一致。
  • [ok] 网络面核实 — 无 fetch/requests 类代码;扫描命中的 URL 均为 lockfile registry、模板 @import 与测试数据,属产物期或安装期。
  • [ok] 判级口径 — 目录内零凭证读取、写盘限于 /tmp 与最终交付物,符合 blue(仅本地脚本/CLI 与本地读写)。
  • [ok] meta 核定值未改动 — license/stars/last_push/official_desc 与骨架一致,installs 保持 null(无可定位到本 skill 的安装量)。

6结论

  • 把「文本→图」的设计纪律写成可执行合同:来源锁 SHA-256、有序原文块账本、白板来源清单、像素与切片双尺度检查,失败即阻断而非兜底。
  • 图与文字分工极清晰,且配了 audit/test/fixtures 三条回归命令,模板升级后仍可复验。
  • 四模具共用一套图像生成协议与品味底线,知识讲解另有 learning-design 校准下上连接,覆盖面广而不散。
  • 适合:需要把长文/论文/书籍、技术概念、原文手稿或论证过程铸成 1080px 可读长图,且愿接受「来源锁定 + 校验器 + 像素复核」这套较重流程的用户;也适合做知识讲解卡片(-l/-w)或原文一字不改的全文排版(-f)。
    不适合:只想要一句话或一张随手的普通配图、无法提供可靠来源与事实边界的场景;无法安装 Bun/Playwright 或缺少图像生成能力的环境;以及只翻译一句古文、只写现代文章或通用内容卡片的请求(-f/-c 之外的轻量用途另择)。
    安装 agent 直装可复制
    ① 本站镜像 更新 2026-10-10
    方式 A · 人下载镜像包下载 ljg-card.tar.gz
    sha256: a574935eb0666759…
    方式 B · JSON 格式安装指南,复制给 agent
    安装指南
    agent 读 JSON 指南后会自动从本站下载安装,无需更多说明。
    ② 上游 GitHub · 原始来源
    能访问 GitHub?直接去上游安装(实时版,可能已更新)GitHub 原始 ↗
    本页镜像锁定 commit 9e75497a95;上游为实时仓库。
    来源信息 GitHub 原始
    作者 / 仓库lijigang / lijigang/ljg-skills
    本 skill commit9e75497a95
    许可MIT(仓库根 LICENSE)
    本站信息
    收录日期2026-09-06
    分类基础工具与工作流
    侦查报告AI 侦查 · 2 遍 · 2026-09-06
    本站镜像与 GitHub 原始是不同来源:本站锁定 commit 快照经 /r2 分发;GitHub 为实时上游,内容可能已更新。
    被文章提及
    同分类邻近