1仕組みと動作原理
本ディレクトリにはスクリプトや実行可能コードが一切含まれず、全機能が SKILL.md の手順指示および references/ 内のテンプレートとナレッジベースで構成されています（『プロンプトエンジニアリング＋リファレンスライブラリ』型スキル）。
skills/baoyu-infographic/SKILL.md
Two dimensions: **layout** (information structure) × **style** (visual aesthetics). Freely combine any layout with any style.
ディレクトリ構成は SKILL.md と references/（21種類のレイアウト、22種類のスタイル、base-prompt、analysis-framework、structured-content-template、設定2件、codex-imagegen 説明書）のみであり、.ts/.js/.sh ファイルは存在しません。
推薦アルゴリズムは実行可能な選択ルールとして機能します。キーワードショートカットに合致した場合は内容推論をスキップして直接マッピングされたレイアウトを適用し、それ以外はデータ構造・トーン・読者層に基づいて3〜5組のレイアウト×スタイルを推薦します。
skills/baoyu-infographic/SKILL.md
Skip content-based layout inference for matched keywords.
Step 3 の 3.1/3.2 の2つの分岐に対応しています。また、SKILL.md 内にはフォールバックナレッジとして推薦組み合わせ表（Timeline → linear-progression + craft-handmade など）が用意されています。
厳格な確認ゲートウェイを設置：Step 4 では組み合わせ、アスペクト比、言語、バックエンドに関するユーザー確認を必須としており、デフォルトではエージェントによる独断での画像生成を禁止しています。
skills/baoyu-infographic/SKILL.md
**Hard gate**: this step is mandatory per the [Confirmation Policy](#confirmation-policy)
Confirmation Policy セクションでは、「スキルの明示的呼び出し、パスの提供、キーワードの一致、EXTEND.md のデフォルト値」をすべて単なる推薦用入力と定義し、確認スキップの権限とはみなしません。--no-confirm や「直接生成」などの明示的な表現がある場合のみスキップが可能で、その際も次のユーザー向けメッセージで前提値を明示する必要があります。
画像バックエンドを実行時に解決（ネイティブ imagegen > codex CLI > Cursor ネイティブ > その他ネイティブ > 唯一の非ネイティブバックエンド）し、具体的なルートとして baoyu-image-gen を明記しています。
skills/baoyu-infographic/SKILL.md
route through `baoyu-image-gen --provider codex-cli` (preferred)
仕組み：ピクセル描画の担当をホスト環境の能力検出に委ねつつ、任意のサードパーティ製スキル経路をコマンドレベルで固定しています。これが本スキルの外部依存面（ユーザーコンテンツとプロンプトが外部の画像モデルへ送信される点）となります。
プロンプトファイルの保存が義務付けられています：バックエンド呼び出し前に、再現可能な記録として完全なプロンプトを prompts/NN-{type}-[slug].md に書き出す必要があります。
skills/baoyu-infographic/SKILL.md
**Prompt file requirement (hard)**: write each image's full, final prompt to a standalone file under `prompts/` (naming: `NN-{type}-[slug].md`) BEFORE invoking any backend.
Step 5 にて、レイアウト定義＋スタイル定義＋base-prompt テンプレート＋Step 2 の構造化コンテンツ＋言語を統合してプロンプトを合成します。バックエンドを切り替えてもプロンプトを再作成する必要はありません。
コンテンツの忠実性は厳格なルールです：要約せずそのまま反映し、生成前には認証情報類を必ず除外します。分析フェーズにはインストラクショナルデザインのフレームワーク（学習目標、認知的負荷、データの整合性）を採用しています。
skills/baoyu-infographic/SKILL.md
**strip any credentials, API keys, tokens, or secrets** before including in outputs
同セクションの中核原則：`Preserve source data faithfully—no summarization or rephrasing`。references/analysis-framework.md ではさらに9種類のコンテンツとレイアウト／スタイルのマッピング、および「Data Integrity: Never alter, summarize, or paraphrase source facts」が規定されています。
テンプレートはプレースホルダー化されています：base-prompt.md は {{LAYOUT}}/{{STYLE}}/{{ASPECT_RATIO}}/{{LANGUAGE}}/{{LAYOUT_GUIDELINES}}/{{STYLE_GUIDELINES}}/{{CONTENT}}/{{TEXT_LABELS}} を用いて最終プロンプトを組み立てます。
skills/baoyu-infographic/references/base-prompt.md
- **Layout**: {{LAYOUT}}
同一テンプレート内には Image Specifications、Core Principles、Text Requirements の3つの制約、ならびに `Generate the infographic based on the content below:` と Text labels セクションが含まれます。
明確な成果物・バックアップ規律：infographic/{topic-slug}/ という固定ディレクトリ構造を用い、同名ファイルはタイムスタンプでバックアップし、競合時は時間サフィックスを付与します。
skills/baoyu-infographic/SKILL.md
infographic/{topic-slug}/
Output Structure セクションに source-{slug}.{ext} / analysis.md / structured-content.md / prompts/infographic.md / infographic.png が定義されています。Step 1.2、Step 5、Step 6 ではそれぞれのバックアップ命名規則（例: `analysis-backup-YYYYMMDD-HHMMSS.md`）が定められています。
2つの厳格な「不正防止」ルール：SVG/HTML/canvas などのコード描画でラスター画像を偽装すること、およびコードを用いて生成済みビットマップ上の文字を上書き修正することを禁止しています。
skills/baoyu-infographic/SKILL.md
**⛔ Never substitute SVG, HTML, canvas, or other code-based rendering for raster image generation.**
2つ目のルール：`**⛔ Never repair rendered text by painting over a generated bitmap.**`——パッチ修正ではなく、プロンプト修正による再生成またはレイアウト変更を要求します。後処理として許可されるのはトリミング、リサイズ、圧縮、フォーマット変換のみです。
2コア機能
0121種類のレイアウト × 22種類のスタイルの直交的な組み合わせ（デフォルトは bento-grid + craft-handmade）
02キーワードショートカット（例: 高密度情報大図 → dense-modules + portrait）
03コンテンツ分析 → structured-content.md（タイトル/学習目標/セクション/視覚要素/テキストラベル/データポイントの一語一句違わぬ保持）
04実行時の画像バックエンド解決とフォールバックチェーン（Codex imagegen / codex-imagegen / Cursor GenerateImage / その他ネイティブ / 唯一の非ネイティブ）
05参照画像の3つの利用法（バックエンドへの direct 直接送信 / style 特徴抽出 / palette 16進数カラー抽出）とプロンプト frontmatter への記録
06厳格な確認ゲートウェイと明示的スキップ（--no-confirm / 「直接生成」）。スキップ時は前提値の宣言が必須
07EXTEND.md 設定（優先バックエンド/レイアウト/スタイル/比率/言語/カスタムスタイル）と初回設定フロー
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| api | baoyu-image-gen（第三方 skill，--provider codex-cli 路径；会读该 skill 自己的 provider 凭据） |
| cli | Codex CLI（codex login 订阅态、codex exec） |
| api | Codex 运行时原生 imagegen skill（经由 Skill 工具调用） |
| api | Cursor 原生 GenerateImage 工具（无比例参数、无输出目录） |
| package | bundled codex-imagegen 包装脚本（免装 baoyu-image-gen 时的直调路径；其自身会 spawn codex，用 Codex 订阅而非 API key） |
| cli | bun（运行包装脚本；缺 bun 时 npx -y bun） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: 本ディレクトリに実行可能な独自スクリプトは含まれず、SKILL.md はエージェントに対し画像バックエンド（実行時のネイティブ imagegen / Cursor GenerateImage）の呼び出しを指示します
- 网络端点: 外部ネットワークアクセスの宣言: 解決された画像バックエンドによって発生（Codex imagegen / codex exec は Codex サービスを経由、baoyu-image-gen は選択されたサードパーティサービスを経由）
- 本地工作目录: ファイルの読み書きとアーティファクトの出力: infographic/{topic-slug}/：source-{slug}.{ext}、analysis.md、structured-content.md、prompts/、png
監査ノート： 3段落による判定根拠：① 判定対象は本スキルディレクトリ（SKILL.md + references/、スクリプト・エンドポイント・fetch 処理はなし）；② ディレクトリ自体の内部動作はローカルディスクへの書き込み（infographic/{topic-slug}/ 配下の source/analysis/structured-content/prompts/png およびタイムスタンプ付きバックアップ）；③ オレンジ判定の決定打は、SKILL.md が自身の用途として呼び出す外部生成バックエンドを指定している点：`route through baoyu-image-gen --provider codex-cli (preferred)`（加えて Codex ネイティブの `imagegen`、Cursor `GenerateImage`、同梱の codex-imagegen を指定）。第4期基準の「ユーザー素材やプロンプトを外部生成バックエンドに送信する（アカウント枠の消費、素材の外部送信を伴う）→ オレンジ」に該当します。認証情報はバックエンド側で保持され本スキルはキーを読み取らないため、認証情報による格上げはありません。リバースエンジニアリング、なりすまし、バイパス、セキュリティのダウングレードは存在しません（詳細ページ注意点：選択されたバックエンドが baoyu-image-gen の codex-cli ブランチである場合、内部で codex exec --sandbox danger-full-access を使用しますが、これはバックエンド自体のリスクであり、本スキルはファイルを改ざんしませんが verdict.risks に明記済みです）。
5二重目の独立検証
- [ok] 『21 布局 + 22 风格』数量属实 — references/layouts/ 实际 21 个 .md（linear-progression…dense-modules），references/styles/ 实际 22 个 .md（craft-handmade…retro-popup-pop）；SKILL.md 两张 Gallery 表逐项对应。
- [ok] 本目录无脚本/无端点/无凭证 — 目录内文件全为 .md；token 扫描 fetch/http/spawn/exec/process.env/API_KEY 零命中。
- [ok] 点名的外部生成后端（判橙依据） — SKILL.md Image Generation Tools 段逐条给出 Codex imagegen、codex-imagegen（含 `baoyu-image-gen --provider codex-cli` 首选路径）、Cursor GenerateImage、其他原生工具；references/codex-imagegen.md 进一步给出直调包装脚本的命令与 'no OPENAI_API_KEY is read or sent' 说明。
- [ok] 确认门禁为硬门禁而非建议 — SKILL.md 'Hard gate: this step is mandatory…' 与 Confirmation Policy 段把显式调用/关键词/EXTEND.md 默认值一律降级为 recommendation inputs；Step 6 亦注明必须先落 prompt 文件。
- [ok] 内容保真与脱敏要求 — SKILL.md Core Principles 原文 'Preserve source data faithfully—no summarization or rephrasing' 与 '**strip any credentials, API keys, tokens, or secrets** before including in outputs'；Step 2 Rules 重申。
- [ok] 反作弊条款（禁 SVG 替代 / 禁位图涂改） — 两段 ⛔ 文本均在 SKILL.md，且 Text correction policy 段限定后处理只能做裁切/缩放/压缩/转格式。
- [discrepancy] references 里 styles 定义的数量在 SKILL.md 自身文本中有笔误 — SKILL.md 末尾 References 列表写 'references/styles/<style>.md - 21 style definitions'，但 Style Gallery 与目录实际均为 22 个（frontmatter 描述也写 '22 visual styles'）。结论以目录/表格为准＝22；此为文档小笔误，不影响判级。
- [ok] codex-imagegen 直调路径可能导致下游红档行为 — 本 skill 的 references/codex-imagegen.md 指示在无 baoyu-image-gen 时直调 bundled 包装脚本，而该包装脚本（skills/baoyu-image-gen/scripts/codex-imagegen/spawn.ts）以 codex exec --sandbox danger-full-access 运行——红线属被调后端，改写为本 skill 的判级不成立，但已写进 verdict.risks 供用户知情。
6結論
最適な用途： 長文記事、レポート、教材コンテンツを1枚の自己完結型高密度インフォグラフィックに変換したい場合（特に dense-modules + morandi-journal/pop-laboratory による「高密度情報大図」）や、安定したビジュアル表現を求め EXTEND.md でレイアウトやスタイルを固定したいクリエイター／講師に適しています。「生成前にまず構成案を確認したい」ユーザーの要求に厳格な確認ゲートウェイで応えます。
不向きな用途： ピクセル単位の厳密な制御やプログラムによる自動レイアウトが必要な用途（チャートライブラリや SVG コード描画を使用すべきであり、本スキルでは代替手段としてのコード描画を明示的に禁止しています）、利用可能な画像バックエンドが一切ない環境（確認段階で停止します）、機密文書をマスキング処理せずに外部モデルへ渡す運用、ならびに複数回の再生成を許容せず一発での出力を求める大量バッチ処理には適していません。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload baoyu-infographic.tar.gz
sha256:
Option B · Copy Guide for Agent68d6840b2ed27261…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 1567581c26.