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

ljg-classic

"古文逐字注解、组合排版、章节意旨图与全章解读生成器。把原文、字词注、句义注、无字顶部配图和章节解读排成一张可读的长 PNG。USE WHEN 用户调用 ljg-classic OR 要求给文言文、古诗文、经史子集做逐字注解、彩色夹注、章节解读、古文讲义图、章节配图。NOT FOR 只翻译一句古文、只写现代文章或通用内容卡片。"

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

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

输入必须能确定原文、书名与章节;版本不明时保留异文边界,不替用户拍定底本。

skills/ljg-classic/SKILL.md
输入必须能确定原文、书名、章节;版本不明时保留异文边界。
注:这里在做什么:把「底本不确定」当显式边界处理,而不是静默选一种读法。

三层彩色夹注各有语义色与回答的问题:青色 word 注字词义、朱色 clause 注句子动作、赭色 variant 标异文与不确定处。

skills/ljg-classic/References/AnnotationMethod.md
| `word` | 青色 | 这个字词在此处是什么意思 | 古今义、虚词功能、语法、读音 |
注:这里在做什么:用颜色承担语法角色,让读者一眼区分词义、句义与异文三类注解。

「逐字」以覆盖率兑现:所有非标点 token 都必须有 note;成词、虚词、通假按最小有意义单位注,不机械拆单字。

skills/ljg-classic/References/AnnotationMethod.md
“逐字注解”通过覆盖率兑现:所有非标点 token 都有 note。
注:这里在做什么:把「逐字」定义成 100% 覆盖,而非把固定词拆成失去意义的单字。

渲染器读 UTF-8 JSON,按 token 顺序拼接 text 必须与 original 逐字一致;非标点 token 必填 note 与 tone。

skills/ljg-classic/References/InputSchema.md
按 token 顺序拼接 `text`,必须与 `original` 逐字一致。
注:这里在做什么:用拼接不变量把「原文主干」做成机器可校验的契约。

排版只做一件事:眼睛先沿黑色原文读,遇阻力看身边的彩色注,读完整章自然落到蓝色章节解读。

skills/ljg-classic/References/LayoutGrammar.md
页面只做一件事:让眼睛先沿黑色原文读,再在遇到阻力时看身边的彩色注,读完整章后自然落到蓝色解读。
注:这里在做什么:确定整张长图的阅读动线与三层视觉分区。

默认调用内置 image_gen 生成一幅无字、低干扰的章节意旨图放在章节标题与原文之间;图像不可用时继续出无图版本并说明。

skills/ljg-classic/SKILL.md
默认调用内置 `image_gen` 生成一幅无字、低干扰的章节意旨图,放在章节标题与原文之间;图像不可用时继续生成无图版本并说明。
注:这里在做什么:顶部配图负责压缩母题,缺图时降级而非阻断。

每次运行先建独占 /tmp/ljg-classic-* 工作区,JSON、HTML、manifest、意旨图、候选 PNG 与 QA 切片都只放该工作区;验收后再复制到 $HOME/Downloads/。

skills/ljg-classic/SKILL.md
候选 PNG 完成硬验收后,才复制到 `$HOME/Downloads/` 作为最终卡片;用户显式指定另一最终路径时以本次指令为准。
注:这里在做什么:把中间产物与最终交付分离,并读回两者 SHA-256 一致性。

章节解读只保留一个主关系,先直白再准确:章内零件、条件触发动作、结果、迁移或失效边界。

skills/ljg-classic/References/AnnotationMethod.md
章节解读只保留一个主关系。
注:这里在做什么:防止把逐句译文重新拼成一段或写成金句合集。

注解不能改写原文:底本疑似错字、通假或版本差异用 variant 标出,不能静默替换。

skills/ljg-classic/SKILL.md
注解不能改写原文。底本疑似错字、通假或版本差异用 `variant` 标出,不能静默替换。
注:这里在做什么:守住原文与解释的分界,异文只标注不擅改。

工具链为本地 Bun/Playwright:RenderClassic.ts 渲染、ValidateClassic.ts 校验,均由 package.json 脚本暴露。

skills/ljg-classic/package.json
"render": "bun Tools/RenderClassic.ts",
注:这里在做什么:渲染与校验都是本地命令,不依赖远程排版服务。

2核心能力

01古文逐字注解:所有非标点 token 都有对应注解,覆盖率 100%
02三类彩色夹注系统:word 青(字词义)、clause 朱(句动作)、variant 赭(异文与不确定处)
03组合排版:原文 token 与注解组成不可拆单元,标点跟随邻接 token 避免孤行
04章节意旨图:横向 3:2、无字低干扰,嵌入章节标题与原文之间并保安全边缘
05章节解读区:暖纸深墨、单一主关系,标题只写「章节解读」不加营销副标题
06输入 JSON schema 与渲染契约:original 拼接一致、非标点 token 必填 note/tone、JSON 不放 HTML
07自带 render/validate/test 工具链,均为本地 Bun 命令
08交付纪律:PNG 存在不算完成,须核对尺寸、标题章节、注解覆盖、页面底部与整图/切片
09拼音只注会改变理解的生僻读音、多音字与古音提示,无法确认时不猜而改用 variant

3外部依赖

类型依赖
packageplaywright
host-tool内置 image_gen(章节意旨图)

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

风险提醒:蓝色 · 知晓即可
  • 高度依赖内置 image_gen 生成意旨图;无图像能力时只能出无图版本,视觉呈现打折。
  • 注解与解读质量依赖模型对古文的判断,非标点 token 覆盖率虽可校验,但注解是否准确仍靠人工复核。
  • 运行依赖 Bun + Playwright,环境缺失时无法渲染出一致的长图。
风险提醒:蓝色,仅本地脚本与本地读写,可放心使用。判级对象=本 skill 目录(skills/ljg-classic/:SKILL.md + References/ + Workflows/ + Tools/ + package.json)。逐项核实:执行面只有本地 Bun + Playwright(RenderClassic/ValidateClassic/test),写盘限于独占 /tmp 工作区与最终交付 PNG 到 $HOME/Downloads/,零凭证读取、零网络请求代码。风险扫描命中的 URL 全部位于 RenderClassic.test.ts 的测试数据(example.com 占位图与维基文库来源字符串),仅作为字符串与来源元信息,不产生网络请求;命中的「执行外部程序」一条实为 Workflows 文档中「不得改用 npm/npx/Python 排版脚本」的否定句。故定 blue。

5第二遍独立确认

  • [ok] 文件名与类型一致性 — SKILL.md、三份 References、Workflows/AnnotateAndRender.md、Tools/RenderClassic.ts、Tools/ValidateClassic.ts、package.json 均在 §1 清单中可见。
  • [ok] 逐字注解覆盖率口径 — AnnotationMethod.md 与 InputSchema.md 均要求非标点 token 有 note,SKILL.md Gotchas 亦重申 100% 覆盖。
  • [ok] original 拼接不变量 — InputSchema.md 第 1 条与 SKILL.md 合同一致:token 顺序拼接必须与 original 逐字一致。
  • [ok] 交付路径与临时工作区 — SKILL.md 要求 /tmp 验收后复制到 $HOME/Downloads/ 并读回 SHA-256,与 gotchas 一致。
  • [ok] 网络与凭证面 — 扫描命中的 URL 均为测试数据字符串;目录内无 fetch/curl、无 env/API key 读取。
  • [ok] 判级口径 — 仅本地脚本与本地读写、零凭证零网络,符合 blue。

6结论

  • 把古文注解拆成可执行的契约:token 覆盖率 100%、original 拼接逐字一致、JSON 中不放 HTML,机器可校验。
  • 三层彩色夹注与暖纸深墨解读区构成清晰的阅读动线,颜色承担语法角色而非装饰。
  • 交付纪律扎实:/tmp 验收候选、Downloads 交付最终、SHA-256 读回一致,PNG 存在不等于完成。
  • 适合:需要对文言文、古诗文或经史子集做逐字注解、彩色夹注、章节意旨图与全章解读,并输出一张可读长 PNG 的用户;也适合把《道德经》《论语》等整章做成讲义图。
    不适合:只翻译一句古文、只写现代文章或通用内容卡片;也非通用「内容→图」工具(那类需求属 ljg-card),不适合需要即时交互或大量版本岔路的场景。
    安装 agent 直装可复制
    ① 本站镜像 更新 2026-10-10
    方式 A · 人下载镜像包下载 ljg-classic.tar.gz
    sha256: 5821f03373434196…
    方式 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 为实时上游,内容可能已更新。
    同分类邻近