技術記事の構成案を作るプロンプト

技術記事を書こうと思い立ったものの、「どんな見出し構成にすればいいか」を考えている間に時間が過ぎてしまい、結局書き始められないことはないでしょうか。書きたいことは頭の中にあっても、構成に落とし込む作業は意外と時間がかかります。

このプロンプトは、記事のテーマと伝えたいポイントを伝えるだけで、AIにタイトル案・見出し構成・各見出しの要点までまとめて作成させるものです。コピーしてそのままChatGPTやGeminiなどに貼り付けて使えます。

コピペ用プロンプト

以下のコードブロックの中身をそのままコピーして、AIチャットに貼り付けてください。【】で囲まれた部分はご自身の状況に合わせて書き換えてください。

あなたは経験豊富なテックライターです。以下の情報をもとに、技術記事の構成案を作成してください。

【記事のテーマ】: React 19の新機能「use」フックの使い方
【想定読者層（経験レベル）】: 実務経験1〜3年程度
【記事で伝えたい一番のポイント】: 従来のuseEffectでのデータフェッチと比べて、useフックがどう書き味を変えるのか
【実際に使った技術スタック・環境】: React 19, TypeScript, Next.js
【記事のボリューム感】: medium（10〜15分で読める）

# 出力してほしい内容
1. 記事タイトル案を2〜3パターン
2. 見出し構成（H2・H3レベルまで）
3. 各見出しで書くべき内容の要点（箇条書き2〜3点ずつ）
4. コードサンプルを入れるとよい箇所の指摘

# 出力フォーマット
見出し構成はインデントを使って階層が分かるように示してください。

# 制約条件
- 単なる公式ドキュメントの要約で終わらせず、実務での使いどころや注意点に触れる構成にする
- 読者の経験レベルに合わせて、前提知識の説明が必要な部分と省略してよい部分を判断する

使い方3ステップ

上記プロンプト内の【記事のテーマ】【想定読者層】【記事で伝えたい一番のポイント】【実際に使った技術スタック・環境】【記事のボリューム感】を、実際に書きたい記事の内容に書き換えます。
ChatGPTやGeminiなどのAIチャットに貼り付けて送信します。
出力された構成案をもとに、実際のコードサンプルや検証結果を加えながら執筆します。

入力例と出力サンプル

入力例（テーマを変更した場合）

【記事のテーマ】: Dockerで開発環境をチーム全員で統一する方法
【想定読者層（経験レベル）】: 初学者・未経験者向け
【記事で伝えたい一番のポイント】: 「環境構築で丸1日溶かす」を防ぐための最小構成の考え方
【実際に使った技術スタック・環境】: Docker, docker-compose
【記事のボリューム感】: long（詳細な解説記事）

出力サンプル（抜粋）

見出し構成

H2: なぜDockerで環境を統一すべきなのか

H3: 「私の環境では動くのに」問題

H2: 最小構成のdocker-compose.ymlを作る

H3: つまずきやすいポイントと対処法

カスタマイズのコツ

SEOも意識したい場合は、「狙いたい検索キーワードも踏まえた見出しにして」と追記すると、キーワードを意識した構成になります。
シリーズものの記事を書く場合は、「この記事は3部作の1本目で、次回はXについて書く予定」と伝えると、次回への導線を意識した構成になります。
つまずいた点や失敗談を含めたい場合は、「実装時に苦労した点のセクションも入れて」と出力してほしい内容に追加するとよいでしょう。

注意点

所属企業の非公開のプロダクト情報やソースコードをそのまま記事化しないよう、公開可能な範囲の情報にとどめてください。
技術的な内容の正確性は、公開前に必ず自分で動作確認・裏付けを行ってください。
引用・参考にした記事やドキュメントがある場合は、出典を明記してください。