文章は書けるのに、図で手が止まる
ども!龍ちゃんです。
文章は書けるんですよ。でも図が。
ブログって図があった方がいいですよね。技術ブログでも、何のブログでも。そこは疑ってなくて、あった方がいいのは分かってるんです。ただ、Figmaとかで作るのも図を検討するのもなかなか時間がかかります。
なので、書き終わってから記事を眺めて「なんかここ、文字ばっかりだな」と思ったら1枚差し込む。あるいは面倒で入れないまま出す。そんな感じでブログの装飾をつけていました。
AIを使うようになってから、この辺が大きく変わりました。図を作るのはAIでできるようになったんですよ。HTML(Tailwind)で組ませてPNGにするところまで自動化してあるので、作るのは早い。最近はこれに加えて「どこに追加する?」の判断もAIに移譲して爆速で図解を作っている感じです。
今回は、ブログの図解関連の判断をちゃんとしたプロンプトに変えて、図の要否と置き場所をAIに判断させている話をします。実際に3本の記事に当てた出力も貼ります。
この記事で話すのは「どこに入れるか」だけ
埋めたいところは本当は2つあって、「どこに入れるか」と「どう作るか」なんですよね。ただ、作り方についてはもう別で書いてるので、今回は触れません。
- Claude Code SkillでHTML図解を自動生成 — HTMLとTailwindで図を組んでPNGにする話。この記事の図もこの方式で作ってます
- 図解作成、AIに丸投げしたら「たまに自分より上手い」件 — 気に入った図をreferenceに貯めて、AIの作図を上手くしていく話
作る側はここまで来てるので、残ってるのが「どこに入れるか」だけなんですよね。
あと1つ、隣の話と切り分けておきたくて。「文字の塊が読みにくい」って話だと、たいてい改行や段落分割の話になりますよね。あれとは別の問題を扱ってます。改行は文の長さの問題を解くもので、図は概念の並列関係の問題を解くものです。「AとBがあって、Aはこうで、Bはこうで、しかもAとBは逆向き」みたいな構造は、改行をいくら入れても畳めない。そこは図の仕事だと思ってます。
で、この記事で渡すものは2つです。判断のフローと、具体的なプロンプト。

図にすると4段ありますが、この記事の取り分は①②です。③④は上のリンク先の話になります。
記事を丸ごと読ませて、息が詰まる所を探させる
使っているプロンプトはこれです。
この記事を全文読んで、図を1枚入れるべき箇所があるか見てほしい。
- 文字の塊が続いて息が詰まる所、概念が並列に並んで文章だと追いにくい所を探す
- 見つかったら「どの見出しの直後か」「何を描く図か」を提案する
- 図が無くても読める所には提案しない。最小限でいい
- 入れる必要がなければ「不要」と返してくれていい。数を揃えなくていい
※ すでに入っている図( の行)は考慮して、重複する提案はしないこと。
意図してるのは箇条書きの後半2行です。AIって基本的に何か出してくれるんですよね。親切なので。「図の場所を提案して」と頼めば、頼んだ数だけ出してきます。でも図って、増やせばいいものじゃないですよね。要らない図が3枚入った記事って、文字の壁が図の壁に変わっただけなので。
なので**「無くても読める所には提案しない」「数を揃えなくていい」を先に書いておく**。これで、こっちが図を捨てる作業をしなくて済むんじゃないかと思ったわけです。
ちなみにこの記事、シリーズの他の記事だとエージェントを紹介してるんですが、これはエージェントじゃなくて単発のプロンプトです。定義ファイルも作ってません。1回投げるだけで済むので、そのままにしてます。(内容的にスキル化もありですね!)
あともう1つ。「記事を読ませて離脱しそうな所を探す」という動きは、公開前チェックの記事で書いた辛口係の4つ目の観点とほぼ同じなんですよね。あっちは読者がどこで離脱するかを特定して断罪してくるやつです。動きは同じで、返ってくるものが「断罪」か「図の置き場所」かの違いだけ。今回は後者の話だけします。
実際に3本の記事に当ててみた
自分の記事3本に、上のプロンプトをそのまま投げました。当てたのは全部、図がすでに入っている記事です。
| 対象 | 行数 | 既存の図 |
|---|---|---|
| ブログ執筆パイプラインの記事(下書き) | 287行 | 4枚 |
| 公開前チェックの記事 | 234行 | 5枚 |
| 文体の記事 | 153行 | 3枚 |
図が3枚から5枚入ってる記事たちなので、正直「もう十分です、不要」が返ってくると思ってました。
返ってきたのは、どれも1枚だった
3本とも「1枚」でした。「不要」は一度も返ってきませんでした。
たとえばパイプラインの記事だと、こう返ってきました。
位置: オチの節の「理由は、AIの出力が”合ってるか”を測る基準が…」の段落の直後
何を描くか: 「正しさの基準がどこにあるか」で人間の役割が変わることを示す2列比較図。左=他の工程(基準は外側にある→AI主導・人間は確認役)/右=執筆(基準は自分の中にしかない→人間主導)
根拠: この記事で最も長い純テキストの連続です。約20行がすべて散文で、コードブロック・箇条書き・表が一切入りません(他の節は必ず何かで切れています)。しかもここは記事の回収部=一番読み飛ばされたくない場所です
これ、当たってるんですよね。しかも「他の節は必ず何かで切れている」という比較までしてる。記事全体を読んだからこそ言えることで、部分だけ見せてたら出てこない指摘だと思います。
で、言われたとおりに作ったのがこれです。

左右の対比も、下に置く一行も、提案文にそのまま書いてあった通りです。僕がやったのは、指定された構造をHTMLで組んでPNGにしただけ。この図はいま、提案された位置(パイプラインの記事のオチの節)に入ってます。
作る手間はもともと軽いので、こうやって「どこに・何を」まで決まってしまうと、図を入れるのがほぼ作業になるんですよね。迷ってる時間がなくなるのが一番でかいです。
残りの2本も同じ形でした。「この節だけ図がなくて、内容が純粋な並列マッピングだから読者は頭の中に対応表を作らされる」「既存の図2枚の間隔が空いていて、その区間だけ休符がゼロ」。どれも位置と理由がセットで返ってきます。
頼んでいないのに、捨てた理由が返ってきた
面白かったのはここです。3本とも、提案しなかった箇所とその理由を勝手に付けてきました。
プロンプトに「見送った所も書いて」なんて一行も入れてません。それでもこう返ってきます。
提案しなかった箇所(検討して見送り)
- アウトラインの節: 45行と長めですが、実物のコードブロックと5項目の箇条書きで十分に割れています。図にすると箇条書きの再描画になるだけ
- 公開・記録の節: PV分析が次の企画へ戻るループは図向きの構造ですが、既存の全体図のaltが既に「PV分析が次の企画へ循環する」と明言済み=重複
- 設計原則の節: 並列3項目ですが、太字ラベルで既に視覚的に分かれており、各項目2〜4行。図は装飾になります
「図にすると箇条書きの再描画になるだけ」とか、割と厳しいこと言ってきますよね。
別の記事では「この段落は体験の語りなので、構造化すると体温が落ちる」「引用ブロックの並置がすでに図の役割を果たしていて、図にすると実出力の生々しさが落ちる」というのも返ってきました。体温が落ちるとか生々しさが落ちるとか、こっちが普段使ってる感覚の言葉です。それを理由に「触らない方がいい」と言ってくる。 これが毎回ほしい場合は、プロンプトを改修すれば毎回出してくれるというのが良いポイントですね。
つまり、こっちが捨てる作業をしなくて済んだんですよね。候補を10個並べられて「どれにします?」と聞かれるのが一番しんどいわけで、そこを向こうがやってくれてる。
なぜ「出さない」の判断をAI側に置くのか
世の中のプロンプト例を見ると、だいたい「この記事から図を入れるべき箇所を3つ挙げて」という形なんですよね。数を指定するやつ。
あれをやると、記事に3箇所も要らなくても無理やり3箇所返ってきます。で、そこから2つ捨てるのは人間の仕事になる。捨てる方が判断としてはしんどいのに、しんどい方が手元に残るんですよね。というか、図が多すぎるのはそれはそれで問題ですからねw
ここで自分に突っ込んでおくと、僕のプロンプトも「1枚」って数を言ってます。違うのは数の大小じゃなくて、「無ければ不要と返していい」という逃げ道を一緒に置いてあるかどうかです。「3つ挙げて」は下限の指定で、「1枚あるか見て」は上限+逃げ道になります。
なので、出す段階で絞らせてます。整理すると、判断が2階層に分かれてる形です。
- 出す/出さないの一次判断はAI。「無くても読める所には提案しない」をプロンプトに埋めておく
- 提案された1枚を採るかどうかは人間。ここは渡してません
前半をAIに持たせておくと、後半が軽くなる。実際に返ってきたのは「1枚+捨てた理由」なので、僕がやったのは1枚について「うん、確かに」と言うだけでした。
あともう1つ収穫があって。見送った理由の方が、判断基準の実体になってるんですよね。3本分の見送り理由を並べると、同じ型に収束してました。
- すでに入ってる図が同じことを描いている(重複)
- コードブロックや箇条書き、引用が既に休符として効いている
- 短くて1段落で言い切れている
- 体験の語りなので、構造化すると体温が落ちる
1つ目の重複はプロンプトで「既存の図と重複する提案はしない」と指示してあるので、これは指示どおりなんですけどね。拾い物は下の3つで、とくに最後のは自分で言語化しようとしても出てこなかったやつでした。これが「どこを図の判断とするか」の答えなんですよね。
まとめ:数を揃えさせなかったら、判断が軽くなった
図を作るのはAIに任せられるようになりました。残ったのは「どこに入れるか」で、そこも記事を丸ごと読ませたら判断してくれました。ポイントは数を揃えさせないことで、「無くても読める所には提案しない」を先に書いておいたら、3本とも1枚と、捨てた理由が返ってきました。エージェントとして定義を固めてるわけじゃなくその場のプロンプトなので、毎回この形で返る保証はないです。少なくとも3本ではこうなった、というだけの話として置いておきます。
さっきの逃げ道の話、ここで正直に書いておきます。このプロンプト、「1枚」って聞いてるんですよ。
3本とも1枚返ってきたのは、本当に各記事に1箇所だけ乾いた所があったからなのか、それとも「1枚」と聞いたから1枚に揃えてきただけなのか。**どっちの読みも成立します。**後者だとしたら、置いた逃げ道はほぼ働いてなかったことになる。僕が批判してた「3つ挙げて」型と実質同じですよね。数が3から1に減っただけで。
枚数の指定を外して試せば分かる話なんですが、まだやってません。なので今の時点では「効いてる気がする」までです。「不要」が一度も返ってこなかったのも、抑制が効いてない証拠かもしれない。ここは正直に置いておきます。
あとサムネイルは別問題です。あれは1枚作るのが決まってるので、置き場所の判断が要らない。今回の話には入りません。
図が要るのは分かってる。でもどこに入れるかは分からない。その状態のまま勘で置いてたのが、いまは1枚提案されて「うん」と言うだけになりました。判断が消えたわけじゃないんですが、軽くはなってます。
この記事は、ブログを書く工程を1つずつ書いてるシリーズの1本です。書く前のレビュー、AIに自分の文体で書かせる話、公開前のチェック、タイトルとSEOの仕上げ、それぞれ別の記事にしてます。検証から公開までの全体の流れはこちらの記事でまとめてるので、気になる方はそちらから。
ほなまた〜


