公式ドキュメントの読み方と質問の仕方

旅行先で道に迷ったとき、どうしますか？ 地図を見るか、地元の人に聞きますよね。 プログラミングでも同じです。公式ドキュメント（＝その道具を作った人が書いた説明書）が「地図」で、AI が「親切な地元の人」です。

このレッスンでは、15分で次の2つのコツを身につけます。

• 公式ドキュメントから必要な情報をすばやく見つける
• AI に質問して的確な回答をもらう

---

このレッスンを始める前に、次の準備ができているか確認してください。

• Claude Code、Codex CLI、Cursor、ChatGPT のいずれか1つが使える状態になっている
• 何か一つ、解決したいエラーややりたいことがある（なければ「Next.js でページを追加したい」をテーマにしましょう）

特別な知識は必要ありません。あなたが今困っていることをそのまま持ってきて大丈夫です。

---

公式ドキュメントとは、そのツール（Next.js や Supabase など）を作ったチームが用意した説明書です。 旅のガイドブックと同じで、「全部読む」必要はありません。今知りたいことだけを探します。

探し方の手順

1. ブラウザで検索エンジンを開き「ツール名 docs」と検索する — 例：「Next.js docs」
2. 公式サイトの検索バー（虫めがねアイコン）にキーワードを入力する
3. 左側の目次（＝ページの内容一覧）から関連しそうな項目を探す

良い例：「Next.js でページを追加したい」→「routing」というキーワードで検索する

悪い例：「Next.js 使い方」のように広すぎるキーワードで検索する → 検索結果が多すぎて迷子になります

AI に聞くショートカット: 検索キーワードが思い浮かばないときは、AI に「Next.js でページを追加する方法を知りたいです。公式ドキュメントのどのページを見ればいいですか？」と聞いてみましょう。URL つきで教えてくれます。

---

ドキュメントを開いたら、次の3つに注目しましょう。

全部読まなくて OK。気になる料理の写真と注意書きだけチェックしましょう。

ドキュメントが英語で読めないとき

AI ツールにページの URL をそのまま渡して翻訳してもらいましょう。ツールごとの具体的な頼み方は次のとおりです。

---

ドキュメントを読んでも分からないときは、AI に質問します。ここが一番大切なステップです。

質問のコツはレストランの注文に似ています。

良い注文：「温かい、辛くないカレーライスをください」 悪い注文：「何かいいもの」

AI への質問も同じです。具体的に伝えるほど、良い回答が返ってきます。

良い質問の3つの要素

1. やろうとしていること — 「Next.js で新しいページを追加したい」
2. 今の状況 — 「app/about/page.tsx を作ったがブラウザで 404 エラーになる」
3. エラーメッセージ — 画面に表示されているエラーをそのままコピーして貼り付ける

具体的なプロンプト例

以下のテンプレートをコピーして、カッコ内を自分の状況に置き換えてください。

【やりたいこと】
（例：Next.js の App Router で新しいページを追加したい）

【今の状況】
（例：app/about/page.tsx を作りました。http://localhost:3000/about にアクセスすると 404 になります）

【エラーメッセージ】
（例：ターミナルに Cannot find module と表示されています）

どうすれば直りますか？

良い例：「Next.js の App Router で app/about/page.tsx を作りました。http://localhost:3000/about にアクセスすると 404 になります。ターミナルには Cannot find module と表示されています。どうすれば直りますか？」

悪い例：「動きません。助けてください。」→ AI も「何が動かないのですか？」と聞き返すしかなくなります

ツールごとの質問の投げ方

ポイント: Claude Code と Cursor はプロジェクトのファイルを直接読めるので、「このファイルのエラーを直して」のようにファイル名を指定するだけでも通じます。ChatGPT の場合はコードやエラーメッセージを自分で貼り付ける必要があります。

---

AI から回答をもらったら、すぐに試してみるのが鉄則です。

1. AI が提案したコードや手順をコピーする
2. 自分のプロジェクトで実行する
3. うまくいったら → おめでとうございます！ スクリーンショットを撮りましょう
4. うまくいかなければ → 新しいエラーメッセージをそのまま AI に貼り付けて「さっきの手順を試しましたが、今度はこのエラーが出ました」と伝える

この「質問 → 試す → また質問」の繰り返しが、自分で調べて解決できる力（＝このレッスンのゴール）につながります。

---

---

このレッスンが完了した状態とは、以下の3つすべてを満たしていることです。

• 公式ドキュメントを開いて、自分が知りたい情報が書いてあるページを見つけた
• AI に「3つの要素」を含む質問をして、回答を受け取った
• 回答を試して、結果（成功でもエラーでもOK）のスクリーンショットを1枚撮った

スクリーンショットの撮り方（迷ったらこれ）：

• Mac: Cmd + Shift + 4 で範囲を選択
• Windows: Win + Shift + S で範囲を選択

スクリーンショットを撮ったら、このレッスンは完了です。おつかれさまでした！