1仕組みと動作原理
構造化された deck データを固定テンプレート SloganTemplate.html に流し込み、単一のビルドスクリプトによって単一ファイルの HTML を生成します。生成物の末尾に CSS を追記したり、別のレンダリング分岐を作成したりすることは禁止されています。
skills/ljg-present/SKILL.md
使用 Tools/BuildDeck.ts 把数据装入 SloganTemplate.html；不在产物末尾补 CSS，不另写渲染分支。
ここで行われていること：「レンダリング」を1つのテンプレート＋データ契約に集約し、使い捨てのHTML手書きではなく、常に同一ソースから検証可能な成果物を保証します。
faithful（原文の文言／順序／表／コード／元画像を維持する忠実組版）と editorial（発表用編集、許諾された範囲内でのスクリーン表示テキストの推敲を許可）の2つのコンテンツ契約があり、ユーザーからの要約許諾の有無によって決定されます。
skills/ljg-present/SKILL.md
| faithful 保真排版 | 已有投影提纲；未授权改写 | 原文字句、顺序、表格、代码和源图 |
ここで行われていること：「著者のコンテンツを変更できるか」を明示的な契約とし、「スライド化の依頼」だけで勝手に加筆修正する権限を与えないようにします。
テーマは優先度順に解決されます：明示的な選択 > 明確な theme_* ビジュアルタグ > デフォルトの hacker-dark。一般的なトピック／用途タグはテーマ選択に関与しません。
skills/ljg-present/SKILL.md
显式选择 > 明确的 theme_* 视觉标签 > hacker-dark。普通话题、用途标签不参与主题选择。
ここで行われていること：配色決定のチェーンを固定化し、share や talk などのタグによる誤ったテーマの誘発を防ぎます。
レイアウトは行数ではなく、語りの機能（セマンティックロール）によって決定されます。2行であっても1つの主張として扱われ、行数はフォントサイズと改ページにのみ関与します。
skills/ljg-present/SKILL.md
两行可以是一个判断。role 由讲述功能决定；行数只参与字号与分页。
ここで行われていること：「どの版面を選ぶか」を組版の偶然ではなく意味構造に委ね、主張・対比・関係・エビデンス・章区切りの5大プロトタイプを支えます。
チャート契約：ソースにデータ、順序、または関係が存在する場合にのみ描画します。数値を勝手に補間して曲線を引いたり、並列・相関関係を独断で因果の矢印に格上げしたりしません。
skills/ljg-present/ChartSpec.md
图让关系直接可见。源中有数据、顺序或关系才画；不补数值曲线，不把并列或相关性擅自升级为因果箭头。
ここで行われていること：図の採用基準と矢印の意味論を規定し、見栄えを良くするためだけの関係性の捏造を防ぎます。
Unicode 関係図は等幅グリッドで接続線を描画し、中国語ノードは固定文字マスに無理に詰め込まず、自然な字間で個別に組版します。
skills/ljg-present/SKILL.md
Unicode 连接线使用等宽网格，中文节点独立排版。不要把中文逐字塞进固定字符格。
ここで行われていること：中国語と等幅の罫線が共存する際のアライメント問題を解決し、ループや矢印の可読性を担保します。
静的検証だけでは不十分です。ビルドツールでテンプレートを固定するだけでなく、ブラウザプローブを用いて実際の描画ページを照合し、スクリーンショットで視覚的な主従関係を再確認します。
skills/ljg-present/SKILL.md
静态通过不等于画面成立。构建工具固定模板；浏览器探针核对实际绘制的页面，截图另检视觉主次。
ここで行われていること：「データ／テンプレートの適合性」と「実際の画面が視覚的に成立しているか」を2層に分けて検証します。
納品物は単一ファイルのオフライン HTML です。フォント埋め込み、チャートインライン化、アニメーション完全ゼロで、発表者ノート層とプレゼンター用キーバインドを標準装備しています。
skills/ljg-present/SKILL.md
一个 ~/Downloads/{title}.html，字体内嵌，图表内联，离线、零动效。
ここで行われていること：成果物の形態と操作キー（矢印キー/Space/F/N）を定義し、本番環境でプレゼンター（クリッカー）を用いてそのまま上映できるようにします。
ビジュアル言語はデザインシステムによって制約されます。コンテンツはウォームホワイト／インクブラックが担い、アンバーは1つの強調点や章の境界にのみ使用し、全カテゴリに同時に色を付けることはしません。
skills/ljg-present/DesignSystem.md
默认暖白或墨黑承担内容。琥珀用于一个重点、章节边界或明确状态，不给所有分类同时着色。
ここで行われていること：明確な配色・線描の規律により、各スライドの主役が常に1つに定まるようにします。
2コア機能
01アウトライン／原稿 → 単一ファイルオフライン HTML（BuildDeck.ts + SloganTemplate.html、データ駆動）
02faithful / editorial の二重コンテンツ契約と許諾規律（editingBasis、sourceIds によるソース追跡）
035つのセマンティックレイアウト（主張/対比/関係/エビデンス/章区切り）+ sequence/quotation
04ネイティブチャート契約（bar/line/flow/compare）、有限値・ゼロ基準線・x軸昇順などの厳格なルール
05Unicode 関係図（columns/rows レイアウト + nodes/edges/via ルーティング、中国語ノードの個別組版）
065つのテーマセットと解決優先度（hacker-dark デフォルト、-b/-r/-y 等）
07発表者ノート層とクリッカー操作（Nキーでノート表示、矢印キー/Home/End/F等）
08テンプレート整合性の静的検証（ValidateDeck.ts：データと埋め込みフォント以外のテンプレート改変を不許可）
09ブラウザプローブ + スクリーンショットによる視覚的再検証（ProbeDeck.js が隔離ブラウザ上で実際の描画ページを照合）
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | bun（运行 BuildDeck.ts / EmbedAssets.ts / ValidateDeck.ts；BuildDeck 内部 spawn bun 子进程） |
| cli | 隔离浏览器（加载 ProbeDeck.js 做运行时绘制核对；由宿主提供，非脚本外发） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: Tools/BuildDeck.ts（bun で実行。deck データを読み込み、mkdir + Bun.write で HTML を書き出し、bun を spawn して実行）
- 本地工作目录: ファイルの読み書きと成果物の出力: ~/Downloads/{title}.html（最終的な単一ファイル deck、フォント埋め込み、チャートインライン化）
監査ノート： 青色、通常利用。判定対象はこの skill ディレクトリのみ：内蔵の BuildDeck.ts / EmbedAssets.ts / ValidateDeck.ts / ProbeDeck.js はすべてローカルでデータを読み込み、HTML を書き出し（Bun.write / writeFileSync）、内部の bun 子プロセスを spawn してインライン化と検証を実施——「ローカルスクリプト/CLI およびローカル読み書きのみ」に該当。§3 における 6 件の URL ヒットは個別確認の結果すべて安全なリテラル：`http://www.w3.org/2000/svg` 名前空間、リグレッション検証用の `https://example.com`/`fetch("literal text")`、ValidateDeck テスト用の `<svg>fetch('x')` リテラルであり、実際の外部通信ではありません。「憑證（認証情報）」の 3 件ヒットは実際にはテンプレートトークン／プレースホルダー関連の用語であり、認証情報の読み取りではありません。「沙箱（サンドボックス）」の 1 件は ValidateDeck が構文チェックのために `new Function` で自成果物のスクリプトをコンパイルしているものです。フォントは成果物内に埋め込まれ、生成時の CDN 外部リンクも存在しないため、network_calls / credential_reads は空となり、blue と判定（baoyu-diagram などのローカルスクリプト系先行事例に準拠）。
5二重目の独立検証
- [ok] URL 命中均为安全字面量 — 6 条：w3.org SVG 命名空间 1 条、RegressionDeck.json 与 ValidateDeck.ts 测试字面量 5 条；无 fetch/curl 对真实端点，network_calls=[] 成立。
- [ok] 「凭证」命中非凭证读取 — 3 条命中均为 token/模板一致性（canonical-template、{{DECK_META_JSON}} 占位符）与 help 文案，不读 env/keychain/文件；credential_reads=[] 成立。
- [ok] 沙箱命中为构建期语法检查 — ValidateDeck.ts 用 `new Function(script)` 对自身模板产物做 JS 语法编译（捕获异常记 javascript-syntax），非对不可信外部代码的任意执行；已写入 injection_surface/reason。
- [ok] 写盘面与交付声明一致 — BuildDeck 用 mkdir + Bun.write 写输出 HTML；EmbedAssets writeFileSync 内嵌字体/图片；SKILL.md 交付声明为 ~/Downloads/{title}.html，一致。
- [ok] 无产物期 CDN 字体外链（未夸大离线） — SKILL.md 声明「字体内嵌…离线、零动效」，Fonts/ 内含 IBM Plex Mono ttf 与 OFL，EmbedAssets 负责内联；无不依赖远端字体的证据缺口。
- [ok] 授权契约与编辑依据真实存在 — SKILL.md 两种内容契约表与「仅有『做成演示』不自动授权删改」「记录 editingBasis…sourceIds 回到完整来源」为原文，editorial 约束非臆测。
6結論
最適な用途： Org/Markdown のアウトラインや許諾済みの要約原稿から、Unix 的な質感を持つ単一ファイルプレゼンテーションを作成する用途に最適です。技術発表、社内レビュー、投影距離や視覚的主従関係の厳密な制御が求められる現場上映、および「データ駆動＋再現可能」なスライド作成フローを維持したい場合に適しています。
不向きな用途： 著者のコンテンツを無断で改変する用途や、一般的な企業向け PPT スライドの生成には適していません（description の NOT FOR）。PowerPoint 形式のファイル、派手なアニメーションやテンプレート集が必要な場合、または視覚的再検証のための隔離ブラウザを提供できない環境には不向きです。
Install Agent-Ready
① Verified Mirror 2026-10-10
Option A · Direct DownloadDownload ljg-present.tar.gz
sha256:
Option B · Copy Guide for Agentc5877f065fa8406a…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 9e75497a95.