指示を上手く伝えるコツ
中級曖昧な指示と具体的な指示の違いを体験し、prompt.mdの活用方法を学びます。
座学
この講座で学べること
- ✓「何を・どこに・どんな形で」を意識した具体的な指示の書き方を習得する
- ✓「不明点があれば質問して」の一言で失敗を減らせることを理解する
- ✓prompt.mdファイルに指示を書いてClaude Codeに渡す方法を習得する
- ✓曖昧な指示と具体的な指示の結果の違いを実際に体感する
「ページをきれいにして」と頼んでも、Claude Codeは困ってしまいます。「きれい」の定義が人によって違うからです。AIは読心術が使えません。あなたの頭の中にあるイメージを言葉に変換することが、良い指示の第一歩です。 曖昧な指示でうまくいかない主な原因は「何を・どこに・どんな形で」が抜けていることです。この3つを意識するだけで、指示の精度がぐっと上がります。
良い指示の基本フォーマット： 「【何を】【どこに】【どんな形で】してください」 例） ✗ 「ページをきれいにして」 ✓ 「index.htmlの背景を白（#FFFFFF）、文字を黒（#333333）、フォントサイズを16pxにしてください」 ✗ 「もっとわかりやすくして」 ✓ 「h1タグの見出しを大きく（24px）して、段落の行間を1.8倍にしてください」 「不明点があれば質問して」と一言添えると、Claude Codeが曖昧な部分を確認してから作業してくれるので失敗が減ります。
長い指示を書くときは「prompt.md」ファイルに書いてClaude Codeに渡す方法があります。 プロジェクトフォルダに「prompt.md」というファイルを作り、指示を箇条書きで書いておきます。Claude Codeを起動したら「prompt.mdの内容を実行してください」と伝えるだけです。 この方法のメリット： ・長い指示でも書きやすい（エディタで書けるので） ・過去の指示を再利用できる ・チームメンバーと指示を共有できる
指示の改善ビフォーアフター
BEFORE（改善前）
「ページをきれいにして」
「きれい」の定義が人によって違う。何をどう変えればいいか不明。
AFTER（改善後）
「背景を白（#FFFFFF）、文字を黒（#333333）、フォントサイズを16pxにしてください」
色・サイズを数値で指定。誰でも同じ結果が得られる。
BEFORE（改善前）
「もっとわかりやすくして」
何がわかりにくいのか、どう変えればいいのか、具体性がゼロ。
AFTER（改善後）
「h1の見出しのフォントサイズを24px、段落の行間を1.8倍にしてください」
変更する場所（h1）・変更内容（24px・1.8倍）が明確。
BEFORE（改善前）
「いい感じのやつを作って」
何を作るか、どんな形式か、どんな内容かが一切わからない。
AFTER（改善後）
「index.htmlというファイルを作って、タイトルが「私のページ」のシンプルなHTMLを書いてください」
ファイル名・形式・タイトル内容がすべて含まれている。
prompt.md のポイント
長い指示はチャットに直接打ち込まず、テキストエディタで「prompt.md」に書いてから 「prompt.mdの内容を実行してください」と伝えましょう。 指示を再利用でき、複雑な作業もミスなく伝わります。
実践手順
ステップ1：曖昧な指示を出して結果を確認する
まず意図的に曖昧な指示を出してみましょう。Claude Codeがどう解釈するか確認します。
ページをきれいにしてステップ2：具体的な指示に直して再度試す
今度は具体的な指示に直して伝えてみましょう。結果の違いを比べてください。
index.htmlの背景を白、文字を黒、フォントサイズを16pxにしてください。不明点があれば質問してくださいステップ3：prompt.mdに指示を書いて渡す練習
テキストエディタでプロジェクトフォルダに「prompt.md」を新規作成し、指示を書いてください。その後、Claude Codeに「prompt.mdの内容を実行してください」と伝えてみましょう。
# 指示
- index.htmlのh1タグのフォントサイズを24pxにする
- 段落の行間を1.8倍にする
- フッターに「© 2025 My Page」を追加する確認チェック
講座を終える前に、以下の項目を確認しましょう。