1仕組みと動作原理

実装方式は純粋なプロンプトのオーケストレーション：SKILL.md はイラストを Type（情報構造）× Style（描画手法）× Palette（配色、オプションで上書き可能）の3つの直交する次元に分解し、次元の組み合わせによって画像プロンプトを構築します。スキル自身には実行可能コードが一切含まれていません。

skills/baoyu-article-illustrator/SKILL.md

Analyze articles, identify illustration positions, generate images with Type × Style × Palette consistency.

3次元は自由に組み合わせることができ（`--type infographic --style vector-illustration --palette macaron`）、preset を使って一度に指定することも可能です。Type が情報構造を、Style が描画手法を決定し、Palette が Style のデフォルト色を上書きします。

第一歩は記事の構造分析：コンテンツタイプ、配図の目的、2〜5つのコア論点、および「どの位置に図を入れるべきか」を定め、比喩表現を文字通りに描画することを厳格に禁止します。

skills/baoyu-article-illustrator/references/workflow.md

| Visual opportunities | Positions where illustrations add value |

同一ドキュメント内で「比喩 → 文字通りの描画ではなく基底の概念を描く」ことを CRITICAL と規定：記事内で「チェーンソーでスイカを切る」例えが出た場合、チェーンソーとスイカを描くことは禁止され、その背後にある概念を可視化する必要があります。

生成前にはスキップ不可のディスク保存ゲートが存在：各画像の完全なプロンプトは、再現可能な記録およびバックエンド切り替え時の基準として、まず独立したファイルに書き出す必要があります。

skills/baoyu-article-illustrator/SKILL.md

⛔ **BLOCKING: Prompt files MUST be saved before ANY image generation.**

ファイル名は NN-{type}-{slug}.md とし、YAML frontmatter（illustration_id/type/style/palette/references）を含めます。本文はタイプ別テンプレートを用い、ZONES/LABELS/COLORS/STYLE/ASPECT の構造化セクションを含める必要があり、LABELS は記事の実データや用語を引用しなければなりません。

バックエンド解決は明示的な優先度ルールに従う：現在のリクエストでの指定 > EXTEND.md の preferred_image_backend > 自動選択（Codex imagegen > codex CLI の codex-imagegen > Cursor GenerateImage > その他のホスト標準ツール > 唯一インストール済みのバックエンド > ユーザーへの確認）。

skills/baoyu-article-illustrator/SKILL.md

1. **Current-request override** — if the user names a specific backend in the current message, use it.

これは「スキルが特定の単一生成バックエンドを指定している」決定的な証拠です。文中で Codex `imagegen`、`baoyu-image-gen --provider codex-cli`、Cursor `GenerateImage`、Hermes `image_generate` が候補としてハードコードされており、実行時には実際にこれらのバックエンドが呼び出されます。

2つの厳格な禁止条項により「コードで図を捏造する」手段を遮断：ラスタ生成の代わりに SVG/HTML/canvas を使用することを禁じ、ImageMagick/Pillow/OCR などのプログラム的オーバーレイで生成済みビットマップのテキストを修正することも禁止します。

skills/baoyu-article-illustrator/SKILL.md

**⛔ Never substitute SVG, HTML, canvas, or other code-based rendering for raster image generation.**

テキストに誤りがある場合はプロンプトを修正して再生成するか、ユーザーに不完全な複数の候補から選んでもらいます。後処理は、テキストや主要な構図を変更しないトリミング／リサイズ／圧縮／フォーマット変換などに限定されます。

生成フェーズはデフォルトでバッチ処理：バックエンド固有のバッチインターフェースを最優先し、次にホストの並列ツール呼び出し（デフォルトは1バッチあたり4枚）、最後にシリアル実行を行います。失敗した項目は1回のみリトライし、成功済みの項目は再生成しません。

skills/baoyu-article-illustrator/SKILL.md

dispatch up to `generation_batch_size` images at a time. Default: `4`.

同セクションでは「並列化のためだけにサブエージェントをディスパッチしてレンダリングさせる」ことも禁止されており、サブエージェントはプロンプトの反復改善やクリエイティブな探索にのみ使用されます。

確認ゲートはデフォルトで有効：スキルの明示的な呼び出し、ファイルパスの指定、preset の適用、EXTEND.md のデフォルト値はすべて「推奨入力」とみなされ、ユーザーによる設定確認が完了するまで生成ステップには進みません。

skills/baoyu-article-illustrator/SKILL.md

Default behavior: **confirm before generation**.

現在のリクエストで「直接生成／確認不要／確認をスキップ／デフォルトで出力」と明示された場合のみスキップ可能であり、スキップ時には次のユーザー向け更新で想定された type/density/style/palette/language/backend を明告する必要があります。

設定 EXTEND.md は3段階の探索（プロジェクト > XDG > ユーザーホーム）を行い、見つからなければブロックして初回セットアップを実行。出力先は default_output_dir で決定され、最終的に画像は相対パスで記事に再挿入されます。

skills/baoyu-article-illustrator/SKILL.md

Insert `![description]({relative-path}/NN-{type}-{slug}.png)` after paragraphs.

補助ファイル（outline.md、prompts/）は画像と共に出力ディレクトリに配置されます。記事が貼り付けられたテキストである場合は、illustrations/{topic-slug}/ に固定で保存され、source-{slug} としてバックアップされます。

2コア機能

01記事構造分析とイラスト位置の特定（コンテンツタイプ／目的／コア論点／視覚化の機会）

02タイプ別テンプレートに基づくプロンプト構築（infographic/scene/flowchart/comparison/framework/timeline それぞれにテンプレートを用意）

03Palette による Style デフォルト配色のオーバーライド（palettes/<palette>.md を読み込み、色を置換しつつ Style のテクスチャ表現を保持）

04参考画像の3形態（direct/style/palette）の活用：direct は --ref を使用し、style/palette は特徴を抽出してプロンプト本文に記述

05クロスランタイムなバックエンド解決（Codex imagegen / codex CLI / Cursor / Hermes / baoyu-image-gen）

06バッチ並列生成 + 単一リトライ + 出力バックアップのリネーム（-backup-YYYYMMDD-HHMMSS）

07ユーザー設定の永続化と初回セットアップ（EXTEND.md の3段階探索、未検出時はブロック）

08記事への再挿入と生成物のセルフチェック（outline.md/prompts/画像の3層構造 + 各画像の生成進捗レポート）

3外部依存関係

Kind	Dependency / Endpoint
cli	codex CLI（codex-imagegen 分支）
cli	baoyu-image-gen skill（--provider codex-cli，首选路径）
api	Codex 原生 imagegen skill（Skill 工具调用）
api	Cursor 原生 GenerateImage 工具
network	codex-imagegen wrapper（自述：认证走用户 Codex 订阅，不读 OPENAI_API_KEY）

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

安全運用のための推奨統制措置

Agent 向け

段階的・都度認可、サンドボックス推奨

管理者向け

承認フロー、ロールバック可能、全履歴監査

判定根拠（ファイルパスと抜粋）

本地工作目录: ファイルの読み書きと成果物の出力: SKILL.md の指示に従い agent がディスクへ書き出し：outline.md、prompts/NN-{type}-{slug}.md、生成された画像、EXTEND
SKILL.md: ホスト CLI インタプリタまたは外部実行環境の呼び出し宣言

監査ノート： 。(a) SKILL.md で指定されているランタイムエージェントはローカル処理ではなく外部生成バックエンドです：'**Codex (`imagegen`)** — first, inspect your available-skills / tool inventory.' および 'route through `baoyu-image-gen --provider codex-cli` (preferred)' とあり、Cursor `GenerateImage` や Hermes `image_generate` も同様のルールで列挙されています。SKILL.md の実行により、ユーザーの記事素材と構築されたプロンプトは必然的にサードパーティの画像モデルへ送信され、ユーザーのアカウント利用枠（Codex サブスクリプションまたは設定された provider）を消費します。(b) 同時にローカルディスクへの書き込み（必須ゲートによる prompts/ への先行保存、outline.md、生成画像、EXTEND.md）も行われます。(c) スキルのディレクトリ自体にはスクリプト、内蔵ネットワークエンドポイント、認証情報の読み取り処理は一切含まれておらず、外部通信および認証情報の境界は完全に呼び出されるバックエンド／ホスト側に存在するため、red 判定には該当しません。先行事例（ai-image-generation や nano-banana-2 など「生成バックエンドに素材を渡す」スキル）に基づき、一律 orange 判定となります。

5二重目の独立検証

[ok] 自身目录无脚本/无网络端点/无凭证读取 — 目录内无任何可执行文件；全目录 URL 扫描只命中 github.com/JimLiu/baoyu-skills（frontmatter homepage），无请求端点、无 key/cookie/token 读取。
[ok] SKILL.md 确实点名单一外部生成后端（orange 档依据） — 'Codex (`imagegen`)'、'route through `baoyu-image-gen --provider codex-cli` (preferred)'、Cursor `GenerateImage`、Hermes `image_generate` 四处均在 SKILL.md 正文，且被写成生成前的必经步骤（Do this once per session before any generation）。
[ok] prompt 文件必须先落盘（BLOCKING） — SKILL.md Step 5 与 workflow.md 5.1 两处都写死；workflow.md 另有 Prompt Files 清单确认步骤。
[ok] 禁用 SVG / 禁用位图涂改两条禁令 — SKILL.md 与 workflow 均含；Modification 段重申后处理仅限 crop/resize/compression/format conversion。
[ok] 三维度与 preset 机制 — SKILL.md Three Dimensions 表 + 'Combine freely: `--type infographic --style vector-illustration --palette macaron`' + style-presets.md 均存在，无夸大。
[ok] references 数量与按需加载 — 36 个 styles/*.md + 4 个 palettes/*.md + workflow/prompt-construction/styles/style-presets/usage/config/codex-imagegen 均在盘中；codex-imagegen.md 自述只在该分支被选中时加载。
[ok] meta 元数据（license/stars/commit） — GitHub API：MIT、stargazers 25926、pushed_at 2026-09-10T15:13:43Z；本地镜像 HEAD 1567581c26ec29f4216c6e6835415bf30343b0e3 与任务 pin 一致；仓库根 LICENSE=MIT (c) 2026 Jim Liu。

6結論

次元化 + preset：「何を描くか」を組み合わせ可能な3つの直交パラメータに分解し、試行錯誤を減らしてバッチ全体のスタイルを統一。

再現性のエンジニアリング：プロンプトをまずディスクに保存し、ファイル名と outline を1対1で対応させることで、バックエンド変更や再生成時にも履歴を喪失しない。

明確な品質規律：コードによる図の代行描画や完成画像へのテキスト上書きを禁止し、「プロンプトを修正して再生成する」ことでテキスト問題を解決するようモデルに徹底。

大量生成に対応：デフォルトで4枚並列、失敗時は1回のみリトライ、成功済みは再実行しない仕組みにより、長文記事（6枚以上）の画像生成コストを抑制。

クロスホストでの移植性：同一のバックエンド解決ルールが SKILL.md にインライン化されており、Codex、Cursor、Hermes、素の CLI のいずれでも利用可能なバックエンドに自動解決。

最適な用途： 章ごとにまとめて図版を用意したい長文・チュートリアル・方法論の執筆者や、統一されたビジュアル言語を必要とする連載記事（preset + palette でスタイルを固定）に最適です。Codex や Cursor では、追加設定なしでランタイム組み込みの画像ツールをそのまま利用できます。

不向きな用途： 完全にオフラインでの画像生成が求められる環境や、外部へのコンテンツ送信が厳禁されている環境には不向きです。ベクター図や編集可能なダイアグラムが必要な用途（baoyu-diagram や専用デザインツールを使用すべき）や、「手軽に飾り画像を1枚入れたいだけ」という低要件な用途（確認ゲートやプロンプトのディスク保存手順があるためオーバーヘッドが大きい）には適しません。

Install Agent-Ready

① Verified Mirror 2026-09-15

Option A · Direct DownloadDownload baoyu-article-illustrator.tar.gz

sha256: 842c4e88785ed928…

Option B · Copy Guide for Agent

install.json

Agent はこの JSON ガイドから自動的にダウンロードして検証します。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit 1567581c26.