ワークフロー&基本ツール · lijigang/ljg-skills

ljg-classic

"漢文・古文の逐字注釈、複合組版、章の意旨図、および全章解釈の生成ツール。原文、語句注、句意注、文字なしヘッダー画像、章の解釈を1枚の読みやすい長尺PNGにまとめます。ユーザーが ljg-classic を呼び出した場合、または漢文、古詩文、経史子集の逐字注釈、カラー割注、章の解釈、講義用画像、章の挿絵の作成を求めている場合に使用します。1文のみの漢文翻訳、現代文の執筆、汎用コンテンツカードの生成には適していません。"

L4 高権限 · 段階的認可と監査V1 コミット固定コマンド実行ファイル書き込みDual-pass Audit
Author lijigangGitHub lijigang/ljg-skills ↗License MIT(仓库根 LICENSE)Commit 9e75497a95
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

1仕組みと動作原理

入力情報から原文、書名、章を特定できる必要があります。底本が不明な場合は異文の境界を保持し、勝手に底本を決定しません。

skills/ljg-classic/SKILL.md
输入必须能确定原文、书名、章节;版本不明时保留异文边界。
ここでの処理内容:「底本の不確定さ」を暗黙に1つの解釈に絞るのではなく、明示的な境界として扱います。

3層のカラー割注はそれぞれ固有のセマンティックカラーと役割を持ちます:青(word)は語句の意味、朱(clause)は文の動作、黄土(variant)は異文や不確定な箇所を示します。

skills/ljg-classic/References/AnnotationMethod.md
| `word` | 青色 | 这个字词在此处是什么意思 | 古今义、虚词功能、语法、读音 |
ここでの処理内容:色に文法的な役割を持たせることで、読者が語義・句意・異文の3種の注釈を一目で識別できるようにします。

「逐字」はカバー率によって保証されます:句読点以外のすべての token に note が必須です。連語、虚辞、通仮字は最小の意味単位で注記し、機械的に1文字ずつ分解しません。

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` 逐字一致。
ここでの処理内容:連結不変条件を用いて「原文の主幹」を機械検証可能なコントラクトにします。

組版の目的はただ1つです:視線がまず黒い原文に沿って進み、引っかかりがあれば横のカラー注釈を確認し、章を読み終えると自然に青い章の解釈へと至る動線を作ります。

skills/ljg-classic/References/LayoutGrammar.md
页面只做一件事:让眼睛先沿黑色原文读,再在遇到阻力时看身边的彩色注,读完整章后自然落到蓝色解读。
ここでの処理内容:長尺画像全体の読書動線と3層の視覚的ゾーニングを確定します。

デフォルトでは組み込みの 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 の一致を検証します。

章の解釈では主要な関係性を1つだけ維持し、装飾よりも簡潔・正確さを優先します:章内の構成要素、条件によってトリガーされる動作、結果、応用または適用の限界境界。

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%)
023種のカラー割注システム:word 青(語義)、clause 朱(文の動作)、variant 黄土(異文・不確定箇所)
03複合組版:原文 token と注釈を分割不可ユニット化し、句読点を隣接 token に追従させて孤立行を防止
04章の意旨図:横長 3:2、文字なし低ノイズ、章タイトルと原文の間に安全マージンを確保して埋め込み
05章解釈エリア:生成り和紙調背景に濃墨文字、単一の主関係のみを記述し、タイトルは「章节解读」のみで宣伝用サブタイトルは排他
06入力 JSON スキーマとレンダリング規約:original 連結の一致、非句読点 token の note/tone 必須、JSON 内の HTML 混入禁止
07render/validate/test のローカル Bun コマンドツールチェーンを内蔵
08納品基準:PNG の存在のみでは完了とみなさず、寸法、タイトル・章、注釈カバー率、ページフッター、画像全体/スライスを厳格に照合
09ピンインは解釈を左右する難読漢字、多音字、古音のヒントのみに付与し、不確実な場合は推測せず variant で注記

3外部依存関係

KindDependency / Endpoint
packageplaywright
host-tool内置 image_gen(章节意旨图)

4推奨統制措置と判定根拠

安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠(ファイルパスと抜粋)
  • scripts/: ローカルスクリプトまたはコマンドの実行: bun Tools/RenderClassic.ts:ローカルの Playwright でレンダリングし、UTF-8 JSON を読み込んで PNG を出力。
  • 本地工作目录: ファイルの読み書きと成果物の出力: 排他的な /tmp/ljg-classic-* ワークスペース:JSON、HTML、manifest、意旨図、候補 PNG、重複 QA スライス。
監査ノート: リスク評価:青(Blue)。ローカルスクリプトの実行およびローカルファイル読み書きのみで構成されており、規約に準拠して安全に使用可能です。評価対象=本スキルディレクトリ(skills/ljg-classic/:SKILL.md + References/ + Workflows/ + Tools/ + package.json)。個別確認:実行面はローカルの Bun + Playwright(RenderClassic/ValidateClassic/test)のみであり、ディスク書き込みは排他的な /tmp ワークスペースおよび $HOME/Downloads/ への最終 PNG 納品に限定され、認証情報の読み込みやネットワークリクエストのコードは皆無です。リスクスキャンで検出された 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 混入排除により、機械検証が可能。
  • 3層のカラー割注と落ち着いた紙面トーンの解釈エリアが明確な読書動線を形成し、色が装飾ではなく文法的な機能を担う。
  • 徹底した納品規律:/tmp での候補検証、Downloads への最終納品、SHA-256 による整合性確認を実施し、単なる PNG 生成で完了とみなさない。
  • 最適な用途: 漢文、古詩文、経史子集に対して逐字注釈、カラー割注、章の意旨図、全章解釈を付与し、1枚の読みやすい長尺PNGとして出力したいユーザー。また、『道徳経』や『論語』などの章全体を講義用グラフィックにまとめたい場合にも適しています。
    不向きな用途: 1文のみの漢文翻訳、現代文の執筆、汎用コンテンツカードの作成。また、汎用の「コンテンツ→画像」ツール(その用途には ljg-card が該当)ではなく、リアルタイムな対話や多数の版の分岐処理を求めるシナリオには適していません。
    Install Agent-Ready
    ① Verified Mirror 2026-10-10
    Option A · Direct DownloadDownload ljg-classic.tar.gz
    sha256: 5821f03373434196…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 9e75497a95.