うまくいかないとき

不具合は必ず起きます。起きたことをそのまま Claude に伝えるのが、いちばんの近道です。

不具合は、起きて当たり前

どんなアプリにも不具合はあります。経験の長いエンジニアが作っても同じです。不具合が出たのは、あなたが何かを間違えたからではありません。

直すのは Claude です。あなたの役割は、起きたことを、そのまま伝えることです。原因を自分で考える必要はありません。

伝えることは4つ

  1. どこで — アプリの名前と画面。プレビューなのか、本番なのか
  2. 何をしたら — どのボタンを押したか、何を入力したか
  3. どうなった — 実際に起きたこと
  4. どうなってほしい — 本来はこうなるはず、という内容
不具合を伝える
Claudeプロンプト
【アプリ名】で不具合があります。原因を調べて、専門用語を使わずに説明したうえで、直してください。 どこで：【例：本番の、忘れ物の登録画面】 何をしたら：【例：品名を入力せずに「保存」を押した】 どうなった：【例：画面が真っ白になった】 どうなってほしい：【例：「品名を入力してください」と表示してほしい】 画面に出たメッセージ： 【あれば、そのまま貼り付ける】 直すときは、main から新しいブランチを作り、ビルドが通ることを確認してから、main へのプルリクエストを作成し、PR の URL を教えてください。

まだマージしていない PR のプレビューで見つけた不具合は、PR を作ったときと同じ会話で伝えます。その場合、最後の段落は要りません。

本番の不具合も、直し方の流れは小さな変更と同じです。Claude が PR を作り、あなたがプレビューで確かめてマージします。

具体的に伝える

数字や日付は、そのまま書きます。具体的なほど、Claude は早く原因を見つけられます。

伝わりにくい伝わりやすい
合計がおかしい1,000円の品を3つ登録した。合計は3,000円のはずが、2,000円と表示される
並び順が変新しい順のはずが、3月1日のものが3月5日のものより上に表示される
日付がずれる3月5日と入力したのに、一覧には3月4日と表示される

メッセージは、そのまま全部

画面に赤い文字や英語のメッセージが出たら、意味が分からなくても、省略せずにそのまま全部をコピーして貼り付けます。自分の言葉に言い換えると、手がかりが減ってしまいます。

画像を貼る

表示の崩れなど、言葉にしにくいことは、スクリーンショットを Claude Code に貼り付けます。

画像に写るものに注意

お客様の名前や連絡先など、個人の情報が写っている場合は、その部分を隠してから貼ります。

Claude とのやり取りがうまくいかないとき

起きていること送る言葉
説明が難しくて分からない今の説明を、専門用語を使わずにもう一度お願いします
作業が途中で止まった続けてください
頼んでいないところまで変えた頼んだ変更だけに戻してください。それ以外の変更は取り消してください
何をしているのか分からないいま何をしているのか、次に何をするのかを教えてください
スキルが見つからないと言われたbrain-vibe-coding-platform フォルダを選んでいるかを確かめ、新しい会話で頼み直します

新しい会話でやり直す

同じ会話で何度直してもらっても良くならないときは、新しい会話で、最初から伝え直します。

新しい会話で、状況を伝え直す
Claudeプロンプト
【アプリ名】の PR【PR の URL】で作業していましたが、うまく直りませんでした。状況を整理し直したいです。 やりたかったこと：【最初に頼んだ内容】 今の問題：【どこで、何をしたら、どうなるか】 まず、この PR の変更内容と今の状態を調べて、何が起きているのかを専門用語を使わずに説明してください。そのうえで、直し方を提案してください。私が「OK」と言うまで、ファイルは変更しないでください。

自分で直そうとしない

  • GitHub の画面で、ファイルを直接書き換えない
  • 意味が分からないコマンドを、自分で実行しない
  • 本番のデータを、自分で直そうとしない

直すのは、いつも Claude を通してです。Claude の手に負えないことは、管理者に頼みます。

管理者に相談する目安

  • Claude に2、3回頼んでも直らない
  • 本番で、同僚の仕事が止まっている
  • データが消えた、または書き換わった
  • 「マイグレーション」「権限」「シークレット」「環境変数」という言葉が出てきて、判断できない

何を伝えればよいかは、管理者に頼むこと にまとめています。

クイズ

Quiz

Claude に不具合を直してもらうとき、いちばん役に立つ伝え方はどれですか？