Claude Codeで記事の見出し構成を作る

見出し作りを任せるときの要点は、H2/H3を大量に出させることではなく、読者の疑問を順序づけることです。ここでは、公式資料を根拠に構成案を作り、採用前に点検する手順を紹介します。

H2は大きな節、H3はその節の中の小見出しです。Markdownでは##と###で表します。

最初の依頼

見出しの大きさではなく、扱う疑問の範囲で分けます。

• H2：準備この節で「始める前に何が必要？」へ答える。
• その中のH3アカウント／作業場所／権限など、準備の中身を説明。

H3が別テーマを始めていたら、親のH2を見直します。分ける必要がない節にH3を無理に足さなくて大丈夫です。

テーマ：WindowsでClaude Codeを使い始める
読者：ターミナル初心者
読後の行動：公式手順を確認して小さな依頼を実行する
根拠：https://code.claude.com/docs/en/overview
H2は4〜6個を目安にし、H3は説明を分ける必要がある箇所だけ。見出し案だけを出し、事実は追加しない。

Claude Codeはコードベースを読み、ファイルを編集し、コマンドを実行するエージェント型ツールです。利用面や導入方法は更新されるので、記事の見出しに固定的なバージョン番号を埋め込む前に公式概要を確認します。 公式概要

見出しの判定

出力を次の順で点検します。

• H2だけを並べたとき、読者の目的から結論まで流れがあるか。
• 各H3が親H2の具体化になっているか。単独で別テーマならH2へ戻す。
• 同じ疑問を別表現で繰り返していないか。
• 手順、理由、失敗時の確認、限界が必要な記事から抜けていないか。
• 公式資料で答えられない部分に「要調査」と印があるか。

修正は「H2『準備』にアカウント・作業場所・権限の3H3を置き、導入手順と混ぜない」のように範囲を指定します。SEOに強くしてだけでは検索順位を保証できず、見出しが不自然にキーワードへ寄るため、検索意図と読者の質問を具体化します。

形にする

構成が決まったら、記事下書きの手順へ本文を渡します。タイトルは本文と根拠が確定してからタイトル案の比較を行うと、見出しだけで誇張した表現を避けられます。ブログ全体の工程は更新ワークフローで確認できます。

期待結果と限界

期待する出力は、階層、各見出しの役割、抜けた疑問、要確認箇所です。見出し案の良し悪しはAIが保証しません。対象読者、既存記事との重複、法的・技術的な正確性を人が確認し、変更を承認してから本文へ進みます。