1仕組みと動作原理
引数によって4つの型（-l 長画像〈デフォルト〉 / -f 全文 / -c マンガ / -w ホワイトボード）が決まり、それぞれ寸法と画像の役割が異なります。引数がない場合は -l が適用されます。
skills/ljg-card/SKILL.md
| `-l`（默认） | 长图 · 静线叙事 | 1080 × auto | 0–3 幅；有理解增益时用 1 个安静主场景，必要时追加连续视觉拍点 |
ここで行っていること：パラメータ表を用いて型、寸法、画像生成バジェットを紐付け、以降の全手順の分岐点とします。
10段階の共通プロダクションパイプライン：入力の読み込み → ソースと事実の境界の確定 →（知識解説の場合は読者タスクを先行定義）→ キャリブレーション画像の生成 → ディスク保存と画像検証 → テキストを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
截图脚本会等待字体与本地图片。不要绕过它的加载门禁。
ここで行っていること：「フォントと画像の準備完了」をキャプチャの前提条件とし、画像が1枚でも破損している場合は処理を停止します。
-f 全文モードでは順序付き原文ブロック台帳と verify-full-text.ts を使用します。1文字の変更、順序の入れ替え、ブロックの欠落、重複ブロックの4種類の反例に対して、検証ツールは必ず非0コードで終了する必要があります。
skills/ljg-card/references/mode-full.md
验收反例固定为四类：改单字、调序、漏块、重复块。四类中的任意一种都必须让校验工具退出非 0。
ここで行っていること：「原文を一文字も変更しない」という要件を、目視の感覚から実行可能なバリデーター規約へと落とし込みます。
-f モードのフォントはローカルの KingHwa_OldSong を優先し、カード生成のためのネットワークダウンロード、一時インストール、またはリモート参照を禁止します。欠落時はローカルのデフォルトフォントスタックが処理を引き継ぎます。
skills/ljg-card/SKILL.md
不得为了制卡联网下载、临时安装或远程引用该字体。
ここで行っていること：フォント戦略としてローカル優先・欠落時フォールバックを徹底し、リモートフォントへの依存を排除します。
画像生成ではまず視覚モチーフ表とシリーズバイブルを作成し、統一ネガティブプロンプト（画像内の可読テキスト/ロゴ/透かしの禁止）を適用して、同一シリーズ内でのキャラクター、メディア、色彩の連続性を維持します。
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
读者应能从同一段解释中指出：眼前是什么对象，发生了什么动作或状态变化，哪个特征支持归类，关系靠什么条件成立，最后得到什么结果。
ここで行っていること：単にフィールドが埋まっているかを確認するのではなく、コンテンツレビューの具体的な判断基準を提示します。
保守用セルフチェック3コマンド：共有プロトコル/4元参照/ホワイトボードソース照合/全文忠実度および禁止項目を調べる audit、純粋関数と反例を実行する test、代表的なHTMLを生成して実際にキャプチャしPNGを検証する fixtures。
skills/ljg-card/SKILL.md
第一条检查共享协议、四路引用、位图槽、白板来源对账、全文忠实度合同与禁用项；第二条运行纯函数与反例测试；第三条在 `/tmp/ljg-card-v7-fixtures/` 生成代表 HTML，运行全文与白板来源校验，随后用 `capture.ts` 实际截图并读回 PNG。
ここで行っていること：テンプレートやモードをアップグレードした後のリグレッションテストを、再実行可能な3つのセルフチェックコマンドとして定着させます。
2コア機能
01テキストを1080px幅の縦長PNGカードに鋳造（デフォルトは -l 暖色紙・静線ナラティブ長画像）
02-f 原文忠実な全文タイポグラフィ：可視テキストをブロック単位で1度のみ出現させ、文字や順序を変更せず、フォントサイズ/ウェイト/余白のみで編集デザインを実施
03-c マンガ：コマ数は認知的な因果ビートによって決定し、短い内容を無理にコマ埋めせず、長い内容の重要な関係性も削除しない
04-w ホワイトボード垂直論証：単一の .reasoning-spine を主軸とし、chain/branch/timeline/matrix/radial は局所ツールとして利用
05共通画像生成プロトコル：アセット識別4分類（generated/source/brand/structural）、視覚モチーフ表、シリーズバイブル、プロンプト骨格、統一ネガティブ制約、サンプル先行からの一括生成
06知識解説のボトムアップ構造：読者のタスクに応じて素材を選定し、対象と課題、判定基準、関係と条件、具体例と結果、対比例とフィードバックを網羅
07Playwrightベースの内蔵キャプチャツール capture.ts により、指定サイズや fullpage 長画像のキャプチャ、およびホワイトボードソースリストのゲート検証に対応
08保守ツールチェーン：audit.ts（プロトコルおよび忠実度監査）、verify-full-text.ts（全文検証）、prepare-whiteboard-source.ts（ソースリスト準備）、build-fixtures.ts（フィクスチャ回帰テスト）
09共通の美意識基準：判断は装飾に優先、すべての画像は「読者に何を見せるか」に答えること、均一化しないレイアウト、コンテンツ自身で完結する結び
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| package | playwright |
| host-tool | 运行时 image generation 工具 |
| network | Google Fonts（comic_template.html 的 @import，产物期远程字体） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: bun assets/capture.ts <html> <png> <width> <height> [fullpage]：Playwright ヘッドレス実行
- 网络端点: 外部ネットワークアクセスの宣言: comic_template.html 内の @import Google Fonts（生成物向けのリモートフォント。-c レンダリング時にブラウザが fonts.goog を取得する可能性があります）
- 本地工作目录: ファイルの読み書きと成果物の出力: /tmp/<task> 専用ワークスペース：候補画像、ソース画像、HTML/CSS、ベクター下絵、レンダリング入力、キャプチャ下絵、QAスライス、キャッシュ、ログなどのすべての中間生成物。
監査ノート： リスク警告：青色。ローカルスクリプトとローカル読み書きのみであり、コンプライアンスに準拠して利用可能です。判定対象＝本skillディレクトリ（skills/ljg-card/：SKILL.md + 7つのリファレンス + assets スクリプト/テンプレート + ロックファイル）。項目ごとの確認：スクリプト実行面はすべてローカルの Bun/Playwright（capture/audit/verify-full-text/prepare-whiteboard-source/build-fixtures）であり、ディスク書き込みは専用の /tmp と最終成果物のPNGに限定され、認証情報の読み取りはありません。スキャンでヒットしたURLのうち、npmjs registry はロックファイル内にのみ現れ、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結論
最適な用途： 長文/論文/書籍、技術概念、原本原稿、論証プロセスなどを可読性の高い1080pxの縦長画像に変換する必要があり、「ソース固定 + バリデーター + ピクセル再検証」という厳密なフローを受け入れられるユーザー。知識解説カード（-l/-w）や、原文を一字も変えない全文組版（-f）にも適しています。
不向きな用途： 一言だけや手軽な汎用アイキャッチ画像を求めている場合、信頼できるソースや事実の境界を提供できないシナリオ、Bun/Playwrightをインストールできない、または画像生成能力が不足している環境、単なる古文の一節の翻訳、現代文の執筆、一般的なコンテンツカード作成のリクエスト（-f/-c 以外の軽量な用途は別のツールを推奨）。
Install Agent-Ready
① Verified Mirror 2026-10-10
Option A · Direct DownloadDownload ljg-card.tar.gz
sha256:
Option B · Copy Guide for Agenta574935eb0666759…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 9e75497a95.