imagen-infographic は何をしますか?
優れたインフォグラフィックは、複雑な情報を数秒で明確で記憶に残り、スキャンしやすいものに変えます。装飾よりも理解を優先します。このスキルは、仕様を書き、lintし、レンダリングし、返ってきたテキストを確認する、という反復可能なプロセスを実現します。
デザインルール(仕様を書く前に読んでください)
-
明確なメッセージが一つ。 全体を一文で言えなければなりません。その文を最初に
messageとして書いてください。headlineは要点を述べ、読者が約5秒でポイントをつかめるようにします。競合する2つのアイデアがある場合は、2つのインフォグラフィック、または1つの記事セクションにしてください。 -
正確で信頼できるデータ。 ソースマテリアルからの事実のみを使用してください。すべての数値にはソースがあり、フッターにソースを一覧表示します。誤解を招くスケールや都合の良い数字の選択は、チャートがないよりも早く信頼を損なわせます。
-
名前付きの対象読者が一人。 複雑さと語彙を、その読者がすでに知っているレベルに合わせてください。一般的な概要は誰の役にも立ちません。
-
階層とフロー。 サイズ、コントラスト、配置が視線を誘導します。ヘッドライン、次にパネルラベル、そして短いフレーズへ。トップダウンの順序か、明確なモジュラグリッドを使用してください。
-
データに適したビジュアル。
bar:比較用line:経時的な傾向用timelineまたはprocess:順序用diagram:関係性用comparison:並列比較用stat:一つの大きな数字用iconsまたはchecklist:短いリスト用
3D、多くのスライスがある円グラフ、意味のない装飾は避けてください。lintは
pie、donut、radar、3dを拒否します。 -
シンプルさと抑制。 ラベルは短く、フレーズはさらに短く保ってください。2~3種類のフォントと2~4色を使用し、余白を十分に取ってください。セクションに段落が必要な場合、それはインフォグラフィックではなく記事に属します。
-
アクセシビリティ。 テキストのコントラストは少なくとも4.5:1とし、スクリプトでチェックします。項目を区別する唯一の方法として色を使用しないでください。ラベルを付けてください。画像はスマートフォンでも読みやすいままである必要があります。
-
一貫性。 一つのアイコンスタイル、一つのタイポグラフィシステム、均等なスペーシングを使用してください。プロンプトはこれを要求するため、混在した指示で妨げないでください。
失敗モード。レンダリング前にこれらの仕様を確認してください。
- 情報過多、またはトピックが多すぎる
- きれいだが無意味な装飾
- 階層が弱く、読者がポイントを探す必要がある
- 間違った、または歪んだチャート
- ソースの欠落
- 読めないテキスト
ワークフロー
- メッセージを見つける。 ソース(記事セクション、レポート、メモ)を読んでください。一文の
messageを書き、audienceを選んでください。一文書けない場合、その素材はインフォグラフィックには適していません。 - 仕様を書く。 YAMLフロントマター付きのMarkdownファイルです。フォーマットと完全な例は
references/spec-format.mdにあります。3~6個のパネルを使用し、各パネルには短いラベル、ビジュアルタイプ、最大3つのフレーズまたは少数のデータポイントを記述します。 - Lintを実行する。
lintはルール1、2、5、6、7の制限を適用し、問題ごとに1行出力します。制限ではなく仕様を修正してください。それぞれの制限は、過去のインフォグラフィックがそれなしで失敗したから存在します。python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py lint SPEC.md --theme arctic-fox - レンダリングする。
python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py render SPEC.md -o out.png --theme arctic-fox--themeは任意のimagen-diagramsテーマIDを受け付け、パレットとスタイルを設定します。palette:をspec内で設定することもできます。- デフォルトのアスペクト比は3:4の縦長ポスターです。スライド用には
aspect: "16:9"を設定してください。 - スクリプトは画像の隣に
out.prompt.txtを書き出し、何が要求されたかを確認できるようにします。--dry-runを使用するとプロンプトを表示し、費用は発生しません。
- ゲートチェック。 スクリプトは
imagen analyzeで画像を読み戻します。ヘッドライン、すべてのパネルラベル、ソースフッターが存在し、正しくスペルされている必要があります。スクリプトは最大3回試行し(--attempts)、失敗した画像は削除するため、失敗は画像の欠落として現れ、破損画像ではありません。 - 自分で結果を確認する。 PNGを開き、8つのルールに照らしてチェックしてください。ゲートはスペルチェックのみを行います。階層が弱い、チャートのスケールがおかしいといったことは教えてくれません。画像がルールに違反している場合、仕様(単語数を減らす、別のビジュアルにするなど)を変更して再度レンダリングしてください。
画像を記事に埋め込むときは、キャプションと、それが何を示しているかを説明する短い段落を付けてください。画像を見ることができない読者もメッセージを受け取れる必要があります。
シーン:アイデアに取り組む人物
シーンは、記事が描写する瞬間の人物のフラットなイラストです。長いチャットログに頭を抱える開発者、テストが通ってほっとする様子、ホワイトボードに計画をスケッチする様子など。シーンは技術的な記事に親しみやすさをもたらします。シーンには記事内の図の一つをモニターやホワイトボードに表示することができ、人物とコンセプトを結びつけます。記事1つにつき1シーン程度、欲求不満または安堵の瞬間に使用してください。
python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py scene SCENE.md -o scene.png --theme arctic-fox
シーンの仕様は短いフロントマターブロックです(references/spec-format.md 参照)。person(誰が、何をしているか、どんな気持ちか)、setting、オプションの diagram(specからの相対パスのPNG、参照画像として送信)、theme または palette、aspect(デフォルト16:9)を含みます。シーンは独自のテキストを持たないため、テキストゲートはありません。一つ一つを確認してください。感情が一目で読み取れ、画像にタイトル、キャプション、吹き出しがないことを確認してください。
必要条件
imagenCLI(gemini-imagen)がPATH上にあり、動作するキーがあること。- imagen-diagramsプラグイン。
--themeと、そのgenerate.pyにおけるエンジンのフェイルオーバーのため。プラグインがない場合、スクリプトは直接imagen generateを呼び出し、spec内でpalette:を設定する必要があります。 - Python 3 と PyYAML。
スクリプトを変更した後は infographic.py --self-test を実行してください。lintとコントラストルールを、画像呼び出しを行わずにチェックします。