1仕組みと動作原理
描画前に「詳細なコンテンツ分析」を実施：分析フレームワークに従って analysis.md（対象読者、提供価値、コアテーマ、登場人物とストーリーアーク、コンテンツシグナル）を作成し、シグナルに基づいて art/tone/layout およびページ数を推奨します。
skills/baoyu-comic/references/analysis-framework.md
Deep analysis framework for transforming source content into effective visual storytelling.
分量はコンテンツの複雑さに応じて段階分けされ（短編 5〜8 ページ、中編 9〜15 ページ、完全な伝記 16〜25 ページ）、推奨値は後続のステップで参照できるよう analysis.md の front matter に記録されます。
スタイルは art(6) × tone(7) × layout(7) の3次元に preset レイヤーを加えた構成：preset は単なる art+tone のエイリアスにとどまらず、追加のルール（例：ohmsha では「トーキングヘッド」の禁止、視覚的メタファーの必須化など）も適用されます。
skills/baoyu-comic/references/workflow.md
**Preset vs Art+Tone**: Presets include special rules beyond art+tone.
art-styles/、tones/、layouts/、presets/ の4つのディレクトリから必要に応じて定義ファイルをロードします。ohmsha preset にはのび太やドラえもんなどのデフォルトキャラクターがあらかじめ用意されており、ユーザーの指定がない場合はキャラクターの勝手な作成が禁止されています。
キャラクターの一貫性は「キャラクター設定シート ＋ 参照画像」によりエンジニアリング：まずページ間をまたぐ --ref として characters/characters.png を生成し、バックエンドが --ref をサポートしていない場合は各ページのプロンプトにキャラクター説明を埋め込む方式にフォールバックします。
skills/baoyu-comic/SKILL.md
| Exists | Supported | Pass sheet as `--ref` on every page |
障害復旧チェーンも備えています：sips/pngquant で参照画像を圧縮してペイロード制限エラーを回避 → リトライ → それでも失敗する場合は --ref を除外してプロンプト内記述に切り替えます。
ページ生成には厳格な依存関係の順序とバッチ戦略が存在：まずキャラクターシートを生成し、その後ページをバッチでディスパッチします。各ページのプロンプトはディスクに書き込まれてから初めてバックエンドを呼び出すことができます。
skills/baoyu-comic/SKILL.md
Honor workflow dependencies first: generate `characters/characters.png` before pages that use it as a reference.
同セクションには「Never start the first page batch until all selected page prompt files exist on disk」と明記されており、バッチ失敗時は失敗した項目のみを再試行します。
ページをPDFに結合する実行可能スクリプトを同梱：bun で merge-to-pdf.ts を実行し、pdf-lib でドキュメントを構築、画像の実際の寸法に合わせてページを作成し、Bun.write でディスクに保存します。
skills/baoyu-comic/scripts/merge-to-pdf.ts
const pdfDoc = await PDFDocument.create();
スクリプトはファイル名に含まれる NN プレフィックス（00-cover-*.png、01-page-*.png …）でソートし、ページが見つからない場合はエラーで終了します。デフォルトの出力先は <dir>/<dirName>.pdf です。
全体を再実行しない部分ワークフローに対応：絵コンテのみ、プロンプトのみ、画像のみの出力や、特定ページの再生成が可能です。
skills/baoyu-comic/SKILL.md
| `--regenerate N` | Regenerate specific page(s) only (e.g., `3` or `2,5,8`) |
--storyboard-only / --prompts-only / --images-only と組み合わせて使用します。詳細は references/partial-workflows.md に記載されています。
再生成前のバックアップを義務化：既存のプロンプトと画像には統一して -backup-YYYYMMDD-HHMMSS サフィックスを付与してリネームし、比較可能な過去バージョンを保持します。
skills/baoyu-comic/references/workflow.md
**Backup rule**: If `characters/characters.png` exists, rename to `characters/characters-backup-YYYYMMDD-HHMMSS.png`
同一のルールが pages と prompts に適用され、生成失敗ややり直し時に元のファイルが上書きされることはありません。
対話言語はパイプライン全体で一貫して維持：絵コンテ、プロンプト、選択肢、進捗フィードバックはすべてユーザーの入力言語または保存された希望言語を使用します。
skills/baoyu-comic/SKILL.md
**Rule**: Use user's input language or saved language preference for ALL interactions:
技術用語は英語のまま保持されます。言語の優先順位は --lang > EXTEND.md > 会話言語 > 素材言語 です。
2コア機能
01詳細なコンテンツ分析 → analysis.md（対象読者／提供価値／テーマ／登場人物のアーク／コンテンツシグナル）
02絵コンテ ＋ キャラクター設定（storyboard.md、characters/characters.md）。作画前にレビュー可能
03art × tone × layout × preset の選定と自動推奨（ohmsha/wuxia/shoujo/concept-story/four-panel など）
04ページ間をまたぐキャラクターの一貫性（キャラクターシートによる --ref / プロンプト埋め込みの2系統フォールバック）
05ページのバッチ生成 ＋ 単一リトライ ＋ 依存関係の順序制御（キャラクターシートがページより先行）
06ローカルでのPDF結合（bun + pdf-lib、NN プレフィックス順でソート）
07部分的な再実行（--images-only / --prompts-only / --storyboard-only / --regenerate N）とバックアップルール
08--ref ペイロードに適合させるための生成物圧縮（sips / pngquant）
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | bun / npx（${BUN_X} 运行时，跑 scripts/merge-to-pdf.ts） |
| package | pdf-lib（脚本内 import，用于建 PDF） |
| cli | sips / pngquant（压缩角色表，避免 --ref payload 失败） |
| cli | codex CLI / baoyu-image-gen（图像生成后端，codex-imagegen 分支） |
| api | Codex 原生 imagegen / Cursor GenerateImage / Hermes image_generate（宿主原生图像工具） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: scripts/merge-to-pdf.ts（bun で実行。ローカルのページ画像のみを読み込み、PDF を作成）
- 本地工作目录: ファイルの読み書きと成果物の出力: comic/{topic-slug}/ 配下: source-{slug}、analysis.md、storyboard.md、characters/ch
監査ノート： (a) SKILL.md 内で外部の画像生成バックエンドが指定されています：'**Codex (`imagegen`)** — first, inspect your available-skills / tool inventory.' および 'route through `baoyu-image-gen --provider codex-cli` (preferred)'。SKILL.md に従って実行すると、ユーザーの素材（伝記/チュートリアルの原文）と全体の絵コンテプロンプトがサードパーティの画像モデルに外部送信され、複数ページのバッチ処理によりユーザーのアカウントクレジットが大幅に消費されます。(b) 大量のローカルディスク書き込みが発生します：comic/ 配下の素材、analysis、storyboard、characters、prompts、ページ画像、PDF、および EXTEND.md。(c) 同梱スクリプト scripts/merge-to-pdf.ts は完全にローカル処理（pdf-lib による PDF 作成 + Bun.write）であり、ネットワーク通信や認証情報の使用がないため、この部分は青（blue）の特性に該当します。赤（red）の基準（APIのリバースエンジニアリング、クライアントの偽装、保護の回避、任意のコード実行）はいずれも満たしていません。ai-image-generation や seedance などの先例に基づき、「素材を生成バックエンドへ送信する」処理は一貫してオレンジ（orange）と判定されます。
5二重目の独立検証
- [ok] 自带脚本只有 merge-to-pdf.ts，且仅本地行为 — 逐行核对：import fs/path/pdf-lib，createPdf() 里 readFileSync 页面图 → embedPng/embedJpg → Bun.write(outputPath)；无网络调用、无 env 读取、无子进程。
- [ok] pdf-lib 依赖来源（无自带 package.json） — skill 目录确无 package.json；依赖靠仓库根 workspace 的 dependencies（pdf-lib ^1.17.1）或运行环境解析。这一点写进 risks，不影响档位。
- [ok] SKILL.md 点名单一生成后端（orange 依据） — Codex imagegen / codex CLI (baoyu-image-gen --provider codex-cli) / Cursor GenerateImage / Hermes image_generate 均在 SKILL.md 正文，且 7.2 要求“生成任何页面前先读后端 SKILL.md 判断 --ref 能力”。
- [ok] 角色一致性三策略与失败恢复 — SKILL.md 7.2 表（Exists/Supported、Exists/Not supported、Skipped）与 workflow.md 的 Strategy A/B/C 一一对应，另有 --ref 失败时的压缩→重试→降级链。
- [ok] 预设与默认角色 — workflow.md 列出 ohmsha 默认四角色（大雄/哆啦A梦/胖虎/静香）并写明不得为 ohmsha 自造角色；presets/ 5 个文件均在盘。
- [ok] 备份与局部重跑规则 — workflow.md 7.1 备份规则、SKILL.md Partial Workflow Options 表与 partial-workflows.md 均存在。
- [ok] meta 元数据 — GitHub API：MIT、25926 stars、pushed_at 2026-09-10T15:13:43Z；本地 HEAD 与任务 pin 1567581c26ec… 一致。
6結論
最適な用途： 長文記事、伝記、チュートリアルを教育漫画に変換したい個人またはチーム。特にページ間のキャラクター一貫性と完成したPDF成果物を必要とするシナリオに最適です。また、「絵コンテ→プロンプト→画像」のパイプライン設計を研究したいスキル作成者のリファレンスとしても適しています。
不向きな用途： 単一のイラストのみを求めている場合（baoyu-article-illustrator を使用してください）、厳格なオフライン環境や素材の外部送信が禁止されている環境、複数回の確認プロセスを経ず一度で完成させたいラフ作成のシナリオには適していません。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload baoyu-comic.tar.gz
sha256:
Option B · Copy Guide for Agent0b7b74a684ebd49d…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 1567581c26.