YIAN6557/eian-article-art

記事カバーと挿絵（黒板チョーク風）

これは著者 Eian が決めたスタイルです。作業を始める前に examples/final/cover_bw3.png と examples/final/fig6.png を開いて見てください。見てから描いてください。英文記事の場合は examples/final/en/ も参照してください。

ユーザーが別のスタイルを指定したり、他の参考画像を提供した場合は、ユーザーの指示に従い、ここに書かれた内容は適用しません。

以下の <skill> はこのスキルが配置されているフォルダを指します（Codex では通常 ~/.agents/skills/eian-article-art、Claude Code では ~/.claude/skills/eian-article-art です）。

スタイルの厳格なルール

• 背景色：純黒 #000。テクスチャ、グラデーション、枠線なし。
• 線：細く白いチョークの乱線でシルエットを描く。明るい面は線が密、暗い面は粗く、端に数本の散った線を加える。きれいな太い白い輪郭線や灰色の塗りつぶし、発光は禁止。
• 小人：ふっくらとして丸みのある体型、大きな丸い頭、顔なし、服なし。
• 2枚の参考画像（毎回必ず両方添付）：
  • 図1（小人用）：assets/refs/figure_ref.png
  • 図2（線の質感用）：カバー画像には examples/raw/cover_slot_bw_a.png、挿絵には examples/raw/fig2_cost_a.png
  • 図1のみを添付すると、画像が滑らかになりすぎてフェルトのような質感になり、端に白いハローが生じます。
• 色：色を使えるのは2箇所のみ：
  • ツールアイコン（公式色を維持）
  • 測定対象の注釈線と数字（オレンジ #D97757、#E8896A）
  • それ以外はすべて白黒。
• 文字：フォントは Hannotate SC、白色。AI は文字を描かず、すべて HTML で記述します。これにより文字が確実に正しく表示されます。図の中の文字は、記事の言語に従います。
• 内容：1枚の図で1つのことだけを説明し、一目で理解できるように。コーナーインデックス、ページ番号、透かし、装飾を加えない。

サイズとフォントサイズ

図の種類	サイズ	日本語フォントサイズ	英語フォントサイズ
カバー	2000×800、左に図・右に文字	タイトル 92、サブタイトル 50	タイトル 92、サブタイトル 44（2行に分割可）
挿絵	1672×941、上に図・下に文字	ラベル 58、説明 45、全体タイトル 72；最小 45	ラベル 52、説明 40–45、全体タイトル 52–54；最小 40

英語は日本語よりかなり長くなります：1行に収まらない場合は2行に分割するか、フォントサイズを表の最小値まで下げて、文字が画像からはみ出したり画像に重ならないようにします。

記事全体の処理フロー

1. 記事全体を読んで、挿入箇所を選定：references/pick_spots.md に従って枚数を計算し、挿入箇所を選んでリスト表を作成（どの段落の後、何を説明するか、なぜ図が必要か、図の内容、図に表示する文字）。

2. フォルダを作成：記事の隣に <記事名>_挿絵/ を作成し、その中に prompts/、raw/、logos/、final/ のサブフォルダを作成。

3. 一度中断して確認：リスト表と1枚のサンプル画像（通常はカバー画像）をユーザーに提示。ユーザーが承認した後、残りを一気に描画。ユーザーが修正を要求した場合は修正し、それ以外は変更しない。

4. プロンプトを記述：まず references/pitfalls.md を確認。templates/prompt_cover.txt または templates/prompt_fig.txt をベースに編集し、prompts/ に保存。数量、位置のパーセンテージ、文字用の空白を明確に記述。人物の動作は身体の動きで記述し、感情語は使わない。examples/prompts/ には承認済みの完全な例が7つあります。

5. 画像を描画（1枚ずつ、2枚の参考画像を両方添付）：

   • Codex を使用する場合：自身の画像生成ツールを使用し、2枚の参考画像のパスを referenced_image_paths に渡します（図1が先、図2が後）。プロンプトは prompts/ の全文を使用。生成後、ツールが画像の保存場所（~/.codex/generated_images/...）を教えてくれるので、cp で raw/<名前>.png にコピー。
   • Codex 以外の場合（Claude Code など）：スクリプトを呼び出してローカルの Codex で描画します。<記事名>_挿絵/ 内で実行（挿絵の場合は最後の参考画像を fig2_cost_a.png に変更）：

     bash <skill>/scripts/codex_image2.sh prompts/x.txt raw/x.png <skill>/assets/refs/figure_ref.png <skill>/examples/raw/cover_slot_bw_a.png
     

6. 文字を追加：templates/cover.html または fig.html を <記事名>_挿絵/ にコピー。必要なアイコンを logos/ にコピーして、画像と文字を編集（最初に references/layout.md を確認）。その後スクリーンショットを撮る：

   bash <skill>/scripts/shot.sh fig1.html final/fig1.png
   

   スクリーンショットには Chrome を使用。Codex のサンドボックスでは Chrome が起動できないため、スクリプトは FAILED と表示されます。Codex はこの時点で、サンドボックス外で同じコマンドを実行する許可を求め（権限昇格）、その際にユーザーに「この手順は Chrome で Web ページを画像としてキャプチャするためだけです」と伝えます。許可が得られない場合（例：codex exec）、エクスポートスクリプトを作成してすべてのスクリーンショットコマンドをまとめ、ユーザーに「このスクリプトをサンドボックス外で実行してください」と指示します。

7. 確認（すべての画像のスクリーンショットを撮ったら開いて確認し、不十分な場合は再描画または HTML を修正；修正方法は references/pitfalls.md と references/layout.md を参照）：

   • 画像にアルファベット、文字化け、オブジェクトの不足や切り抜きがない。
   • 小人は丸い頭で顔がなく、参考画像と同じ人物であり、硬くなく、宇宙人のように見えない。
   • オブジェクトも乱線で描かれており、明暗がある。定規で描いたような細い線枠ではない。
   • 文字は手書きフォント（Hannotate SC）である。もし普通のゴシック体になっている場合はフォントがダウンロードされていないので、「フォントブック」からダウンロードする。
   • 文字が画像に重なっていない。フォントサイズが上記の表の最小値以上である。文字が画像の外にはみ出していない。
   • 文字とキャンバスの四辺との距離は少なくとも70ピクセル。隣接するラベル間の距離は少なくとも40ピクセル。同じ行のラベルは行数が揃っている。
   • 文字で説明されている内容は、画像自体からも読み取れる必要がある。文字だけに頼らない。
   • すべての画像を examples/final/ のサンプル画像と並べて見比べ、スタイルが統一されていることを確認。

8. ユーザーに納品：

   • final/ 内のすべての PNG。
   • <記事名>_挿絵版.md：原文を一字も変更せず、決定したリストの該当段落の後ろに ![](<記事名>_挿絵/final/fig1.png) を挿入。カバー画像は最上部に配置。
   • リスト表（最終版）。
   • X 記事や WeChat 公開アカウントの下書きに配置する場合は、references/publish_drafts.md を参照（任意。ブラウザ操作が可能なエージェントが必要）。

1枚だけの画像（記事全体でない場合）の場合は、ステップ1をスキップし、ステップ4から開始します。それでも最初にその1枚をユーザーに提示します。

カバー画像のルール

• 左側に1人の小人と1つの大きなオブジェクトを配置し、記事の核心を比喩で表現。例：「ガチャを減らす」という記事なら、小人がスロットマシンを引いている様子を描き、フィルムの山が床に散らばっている。
• カバー画像の描画は 3:2 のアスペクト比で行う（templates/cover.html では 3:2 で画像を配置）。より横長の比率で描画された場合は、まず左端から 3:2 にトリミングしてから配置する。
• 画像は大きく：左半分の高さを完全に埋め、cover_bw3.png と同じくらいの大きさにする。小さく描画された場合は描き直さず、HTML 内で拡大する（references/layout.md を参照）。
• 画像が端に寄りすぎない：画像の左端とキャンバスの左端との距離は72ピクセル以上（#art を拡大した後に再確認）。
• 右側は上から下に：1行のアイコン（記事で言及されているツールのみ。言及されていない場合は配置しない）→ 1行の大タイトル → 1行のサブタイトル。
• タイトルは収まること：日本語のフォントサイズ × 文字数が1200を超えないこと。デフォルトの92ポイントでは最大13文字。それより長い場合はフォントサイズを小さくする（最小76）。それでも収まらない場合は2行に分割。文字が少なくアイコンがない場合は110まで大きくできる。英語の場合は examples/cover_en.html を参照。
• 文字と画像の間は少なくとも40ピクセル空ける。画像が左半分を超えて右にはみ出す場合は、まず #art を少し縮小して、文字が画像に重ならないようにする。
• アイコンは中央の図柄のみを残し、角丸のベースプレートと枠線は削除。assets/logos/ には Claude、Codex、Seedance のアイコンがある。他のツールは公式アイコンを探し、同様にベースプレートを除去する。

必要なもの

• macOS：フォント Hannotate SC は Mac に標準搭載されています（初回使用時は「フォントブック」でダウンロードをクリック）。
• Google Chrome（Chromium または Edge でも可）。スクリーンショット撮影用。
• 画像描画：Codex 自身で描画可能。他のエージェントの場合は、ローカルに Codex（codex コマンドまたは ChatGPT デスクトップ版）がインストールされている必要があり、codex_image2.sh が自動的に検出します。