バイブコーディングがうまくいかないとき、原因の大半はツールではなく指示にあります。

同じツール・同じ課題でも、指示の出し方で結果はまるで変わります。この記事では、現役エンジニアとして実務で使っているAIが誤解しない伝え方を7つに絞って書きます。

この記事の前提

  • 対象:AIツールを使ってコードを書き始めたばかりの方、指示の出し方に自信がない方
  • 前提知識:特定のツール(Claude Code、Cursorなど)の操作方法は前提にしていません。チャット形式でAIに指示を出し、コードやアプリの一部を作ってもらう場面全般に共通する「伝え方」を扱います

用語のかんたん解説

用語 意味
プロンプト AIに送る指示文のこと。この記事でいう「指示」と同じ意味です
MCP AIツールが外部のサービス(GitHubなど)と連携するための仕組みの総称
ハンバーガーメニュー 画面が狭いときに、メニュー項目を三本線のアイコンにまとめて隠す表示方法

コツ1:1指示1目的に区切る

最も効きます。

悪い例

ログイン機能を作って、あとデザインも整えて、テストも書いておいて

良い例

ログイン機能を作って。まずは入力欄と送信ボタンを実装してください。

まとめて頼むと、AIは優先順位を自分で決めます。その判断があなたの意図とずれると、全部が微妙にずれます。小さく区切って、確認しながら積むのが最短です。

コツ2:「どこを」を先に言う

AIは、対象が曖昧だとプロジェクト全体を探しにいきます。時間もかかり、費用も増えます。

悪い例

レイアウトが崩れてる。直して

良い例

ヘッダーのナビゲーションが、スマホ幅で改行されて2段になっている。直してください。

ファイル名が分かるなら、それも添えてください。場所が特定できた瞬間、精度が跳ね上がります。

コツ3:「どうなってほしいか」を書く(「どう直すか」ではなく)

実装方法まで指定すると、AIの得意分野を潰してしまいます。

惜しい例

flex-wrap: nowrap を付けて

良い例

スマホ幅でもナビゲーションを1行に収めたい。入りきらないならハンバーガーメニューにしてほしい

What(どうなってほしいか)はあなたの仕事、How(どう実現するか)はAIの仕事。この分担を崩さないでください。技術に詳しくない人ほど、この形が有利に働きます。

コツ4:エラーは全文そのまま貼る

要約しないでください。

悪い例

なんかエラーが出た

良い例

こういうエラーが出た(以下、ターミナルの出力を全文貼る)

エラーメッセージには、行番号・ファイル名・原因の手がかりが詰まっています。要約すると、その手がかりを自分で捨てていることになります。

これは初心者が最も損をしているポイントです。分からないものほど、そのまま渡す。

コツ5:前提と制約を先に伝える

AIはあなたの環境を知りません。

  • 使っている言語・フレームワーク
  • 動かす環境(ブラウザなのか、手元のPCなのか)
  • やってほしくないこと(「既存のファイルは消さないで」など)

特に3つ目が重要です。禁止事項を先に言っておくと、事故が激減します。

Githubでプロジェクト管理しておいて、mcpか何かで指示出してるAIにと連携しておけばよっぽど事故起きませんけどね。

コツ6:出てきたものを「動かしてから」次を頼む

AIの出力を読んだだけで次に進むと、間違いが積み上がります。

  1. 出てきたものを動かす
  2. 期待どおりか自分の目で確認する
  3. 違っていたら、どう違ったかを伝える

3つ目の伝え方も大事です。「動かない」ではなく「ボタンを押しても何も起きない。エラーは出ていない」。自分の目で見た事実を伝えてください。

コツ7:うまくいったら、その指示を残す

効いた指示は資産です。メモに残しておくと、次から同じ品質を再現できます。

チームで使うなら、プロジェクトのルール(使う技術、命名規則、やってはいけないこと)を文書としてAIに読ませられる形で置いておくと、毎回説明する必要がなくなります。

悪い指示・良い指示 早見表

状況 悪い 良い
依頼の粒度 全部まとめて 1指示1目的
対象 「サイトが変」 「ヘッダーのこの部分が」
内容 実装方法を指定 望む結果を説明
エラー 要約する 全文そのまま
制約 言わない 禁止事項を先に
確認 読んで終わり 動かして確認

指示でつまずいたときの原因パターン

うまく伝えたつもりでも、結果がずれることがあります。よくあるパターンと、確認する順番をまとめます。

起きること 考えられる原因 確認する順番
頼んでいない箇所まで変更される 対象範囲(「どこを」)を指定していない まずファイル名・画面の場所を指定し直す(コツ2)
同じ指示を繰り返しても直らない AIが持っている前提と、あなたの前提がずれている 「今の状態をどう理解しているか」をAIに説明させる
修正のたびに別の場所が壊れる 一度に複数の目的を頼んでいる 依頼を1つの目的まで小さく割り直す(コツ1)
エラーは消えたが動作がおかしい エラーメッセージだけを見て、実際の挙動を確認していない コツ6に戻り、動かして自分の目で確認する

初心者がやりがちで、あとで困る指示

  • 「さっきの続きで」とだけ伝える:会話が長くなるほど、AIも前提を見失います。区切りが悪いと感じたら、状況を一度言葉でまとめ直してから頼んでください
  • 動作確認をせずに次の指示を重ねる:コツ6のとおり、確認前に次を頼むと、原因の切り分けができなくなります
  • 「いい感じにして」で終わらせる:曖昧な言葉はAIにとっても解釈の余地が大きすぎます。良い例のように、状態や条件を具体的に書いてください
  • 禁止事項を後出しする:「それは消さないでほしかった」は事後に伝えても手遅れです。コツ5のとおり、最初に伝えてください

それでも詰まったときは

同じ指示を繰り返さないでください。言い方を変えても直らないときは、たいてい前提がずれています。

  • いったん会話を新しく始める
  • 「今の状態を説明して」と、AIに現状把握を言わせる
  • 作業をもっと小さく割る

それでも1〜2週間動けないなら、独学の限界かもしれません。判断基準は独学ロードマップに書きました。

まとめ

  • 1指示1目的。まとめて頼まない。
  • どこをを先に言う。どうなってほしいかを書く(実装方法ではなく)。
  • エラーは全文そのまま。要約は手がかりを捨てる行為。
  • 禁止事項を先に伝えると事故が減る。
  • 出力は動かして確認してから次へ。

よくある質問(指示の書き方)

Q. 指示は日本語と英語、どちらがいいですか? A. 使っているAIツールが日本語に対応していれば、日本語で問題ありません。曖昧な言い回しを避け、コツ2・コツ3のように対象と望む結果を具体的に書くことのほうが、言語の選択より結果に影響します。

Q. 指示が長くなりすぎるのですが、まとめたほうがいいですか? A. 長さそのものより、1回の指示に目的が複数含まれていないかを確認してください。コツ1のとおり、目的が1つに絞れていれば、多少長くても問題になりにくいです。

Q. 何度言っても同じ間違いを繰り返す場合は? A. 「それでも詰まったときは」で触れたとおり、同じ言い方を繰り返しても直りません。会話を仕切り直し、AIに現状の理解を説明させてから、作業をさらに小さく割ってください。

Q. 指示を打つのが遅くて、コツを実践する余裕がありません A. 音声入力で指示を出す方法もあります。AI音声入力Typelessの実測レビューで、打鍵の手間を減らす選択肢を紹介しています。

Q. ツールによって、指示の伝え方は変えるべきですか? A. 基本的な7つのコツはツールに依存しません。ただしツールごとに得意・不得意があるため、選び方自体に迷う場合はAIコーディングツール比較を参照してください。

次に読む