manga-forge — 自然言語から漫画原稿を焼くスキル

ユーザーの一言から、完成した漫画ページのPNGを出すところまでを担当する。

ユーザーの指示
  ↓ ① ストーリーを書く（このスキルの仕事）
  ↓ ② OMNY にコマ割りを設計する（このスキルの仕事・最重要）
  ↓ ③ scripts/forge.sh で焼く（作画は codex に委譲）
  ↓ ④ 回収（collect.sh）
  ↓ ⑤ 全ページを目で見て検品する（このスキルの仕事）
  ↓ ⑥ 納品（deliver.sh・ユーザー希望の場所へ）
page1.png ... pageN.png

🚨 作業前に必ず読むもの

1. docs/pitfalls.md — ハマりどころ全集。ここを読まずに始めると同じ穴に落ちる
2. prompts/ndm-v10.md — OMNY の書き方の全仕様（スキーマ・コマ割りパターン集・フキダシ9種）。OMNYを書く前に必ず読む
3. omay/standard.omay.yaml — 作画側に渡す規則。中身を知っておくとネームの精度が上がる

---

① ストーリー

• ページ数のデフォルトは 2〜5ページ。指定があればそれに従う。10ページ程度までは一度に焼ける
• 1ページ = 3〜6コマが目安
• 「◯ページ目」の区切りを立てて、起承転結＋見せ場（キメ台詞・感情の着地）を設計する
• ユーザーの指定が薄いときは、直近の文脈・会話から題材を拾ってよい

② OMNY の設計（このスキルの本体）

prompts/ndm-v10.md のスキーマに従って YAML を書く。要点：

• コマ割りは A4（210×297mm）基準の絶対座標。id は右上→左下の読み順
• 🚨 ページ間でコマ割りのパターンを変える。全ページ同じ骨格（大トップ→右→左→大ボトム等）は禁止。隣り合うページで同じパターンにしない
• セリフは必ず bubbles 配列。1フキダシ20〜40文字、長い台詞は分割する
• フキダシの形を shape で指定する（normal / thought / square / caption / flash / uniflash / wobbly / whisper / handwritten）
• 全コマに背景詳細度 bg を付ける（-1/0/1/2）。1ページ内に 0/1/2 が混ざっているのが良い状態。全コマ 2 は禁止、bg:2 は1ページ2コマまで
• 🖼️ bg:1 の action には色だけでなく、その場の要素を1〜2点名指しする（例：「淡い水色のグラデに窓枠と観葉植物」）。「背景は淡いピンクのグラデ」のように色だけ書くと、要素が省かれて色だけのコマになる（docs/pitfalls.md 罠13）
• 🧍 人物センター原則：会話コマは人物をコマ中央に大きく置き、フキダシを人物の右→左に振り分ける。フキダシが顔に重なるときはフキダシ側を退避させる（人物を隅に逃がさない）
• 心の声は monologue: true のフラグだけで表す。テキストに括弧「（）」を書かない（括弧ごと絵に描かれる）
• キメ台詞・感動の着地は「顔のアップ」の大コマにして、action に明記する
• materials に必要な素材（人物・背景・小物）を列挙し、各コマの assets に対応付ける。素材が無くても note を指針に作画AIが自由デザインするので止まらない

⚠️ bbox は「意図の伝達」であって「レイアウトの確定」ではない（docs/pitfalls.md 罠6）。作画AIは構図の自然さを優先してコマ位置を調整する。それは正しい挙動なので、ズレていても壊れてはいない。ただしコマ座標を後工程で使う場合は完成原稿から実測すること。

OMNY は作品ごとにファイルとして保存する（<日付>_<タイトル>.omny.yaml など）。資産として残ると、画風の刷り直しや後工程に効く。

③ 焼く

./scripts/forge.sh -n <OMNYファイル> [-r <立ち絵1>] [-r <立ち絵2>] [-m "作品固有の追加指示"] [-s <画風>] [-o <出力先>]

• -r のリファレンス画像は最大3枚が目安。増やしすぎると効きが薄れる
• -m には「このキャラの特徴は絶対に省略しない」といった作品固有の念押しを書く
• timeout はページ数 × 120秒 + 余裕を見る。10ページなら20分強
• page2 以降は page1 の session id を名指しして codex exec resume <ID> で続きを頼む（forge.sh が自動でやる）。resume --last は他の codex 呼び出しと混ざるので使わない（罠3）。だから焼いている最中に別の画像生成を並走させても大丈夫
• -o を省くと out/<OMNY名>/ に出る。同じ出力先にもう一度焼くと前の原稿が上書きされるので、刷り直し・画風違いは -o で出力先を分ける
• 画風の指定は -s <画風>（下の「🎨 画風の指定」）
• 実際に作画AIへ渡したネームは、出力先の <OMNY名>.used.omny.yaml に残る

🎨 画風の指定

ユーザーが画風を言ったら（「クレヨンで」「水墨画にして」「この漫画を別の画風で」）：

1. ./scripts/styles.sh で一覧を見る。左の列が -s に渡す名前、括弧の中が試し焼きの結果（どれくらい効くか）
2. 近いものがあれば -s <左の列の名前> で焼く。表示名やその一部（-s セル画）でも通るが、候補が複数だと止まるので、左の列の名前を渡すのが確実
3. 一覧に無い画風：
   • 「少女漫画」「劇画」「ギャグ漫画」のような絵柄の指定は、ネームに書く（prompts/ndm-v10.md 手順11の「画風: …」の行を meta.style_notes の先頭に）。-s は付けない
   • 画材・質感の画風で、これからも使いそうなら画風ファイルを足す（下の「画風を変える」）
4. 同じネームを別の画風で刷り直すときは、ネームはそのままで -s と -o out/<作品名>_<画風> を付けて焼き直す（ネームを書き換えない）。毎回新しいセッションで描くので、前の画風は引きずらない

• -s を付けると、ネームに書いてある「画風:」の行は -s の画風に差し替わる（両方は効かない）
• 画風ファイルの memo は依頼文の念押しに自動で足されるので、-m に画風のことを書かなくてよい
• 納品・後工程には、画風の行が入った .used.omny.yaml を使う（⑥）

④ 回収

forge.sh が終わると collect.sh が自動で走り、out/<作品名>/page1.png ... に並ぶ。

⚠️ 作画AIは頼まなくても同じページを描き直すことがある（罠5）。 forge.sh がページごとに描かれた画像を takes.tsv に記録しているので、collect.sh は各ページの最後の1枚を pageN.png に採用し、先の分を rejected/ に分ける。 「画像が無いページがある」と出たら、そのページは宣言だけで終わっている（罠1）。検品では各PNG右上のページ番号（例「3/10」）も確かめる。

⑤ 検品（省略してはいけない）

全ページを実際に開いて見る。チェック項目：

• ページ欠けがない（ヘッダーの「N/M」）
• セリフが読める／キャラの取り違えがない
• 衣装・髪型がページ間で一貫している
• 季節・時間帯と服装・背景が矛盾していない（罠9）
• bg:1 のコマが色グラデだけ・手前の机の縁だけになっていない（人物の背後にその場の要素がある。罠13）
• bg:0 のコマに背景（窓・棚・植物・部屋）が入りこんでいない。自主リテイクされたページは特に見る（罠13）
• フキダシの尻尾が話者を指している（caption・handwritten・offscreen: true は尻尾なし）
• 意図した無音コマが絵だけで成立している

軽微な文字のゆらぎは生成の性質として許容する。気になるページだけ同じ OMNY で該当ページを再依頼する（このとき演出指示を追加しない。素の再依頼のほうが直りやすい）。

⑥ 納品（検品が終わってから）

検品に合格した原稿をユーザーへ渡す。

• ユーザーが置き場所を指定している場合（「デスクトップに置いて」「~/manga に保存して」等）：

./scripts/deliver.sh -f out/<作品名> -t <指定先>/<作品名> -n out/<作品名>/<OMNY名>.used.omny.yaml

• -n でネーム（OMNY）も一緒に納品して資産として残す。-s で画風を入れたときも入っているよう、.used.omny.yaml（実際に渡したネーム）を渡す
• 納品先に前回の納品物があるとスクリプトが止まる。上書きしてよいかユーザーに確認してから --force を付ける
• 指定が無い場合はコピーせず、out/<作品名>/ をそのまま納品場所として扱う
• どちらの場合も最後に必ず報告する：
  • 完成ページの一覧（フルパス）
  • 検品サマリ（チェックリストの結果・再生成したページがあればその旨）
• 🚨 検品（⑤）を通す前に納品しない。rejected/ の画像（自主リテイク前の版。罠5）を混ぜない

---

補足

画風を変える

styles/ に画風ファイルがある（1画風＝1ファイル。./scripts/styles.sh で一覧、./scripts/styles.sh show <画風> で中身、-s <画風> で焼く）。使い方は上の「🎨 画風の指定」。 画風を足すときは styles/_template.yaml をコピーして書き、./scripts/styles.sh check で確かめる（くわしくは styles/README.md）。 大きく変えたいときは 「画材＋支持体（紙）」を指定するのがコツ。「アニメ塗り禁止」「中途半端にきれいにしない」と念押しすると振り切ってくれる。

素材を資産化する

一度デザインが決まったキャラ・背景・小物は、画像として保存して次回のリファレンスに使うと世界の一貫性が保たれる。詳しくは docs/characters.md。

失敗したら

ログ（out/<作品名>/forge.log）に generated_images/<UUID>/...png の行があるか見る。 無ければ宣言だけで終わったケース（罠1）。同じコマンドで再実行してよい。 session id の行すら無いときは codex が起動できていない（罠11・ログイン切れ等）。終了コード 0 を成功と判断しない。