メインコンテンツへスキップ
AMPL/ dev
開発系講座一覧

詰まったときの抜け方

何度頼んでも直らないときは、同じ頼み方を重ねるより、起きることをもう一度起こす手順を書き出し、会話を新しく始めて頼み直すほうが早く抜けられます。締め切りが近ければ、外すという手もあります。

あすの目安が、ときどき、ずれます。Claude が「直しました」と言うのは、これで2回目です。画面を開き直すと、また同じところがずれています。佐藤さん(会社員で、実家の和菓子店を手伝う、架空の人物)は、ノートを開きました。

問い

佐藤さんの疑問

何度頼んでも直らないときは、どうすればいいんだろう。

からまった太い糸の玉から、端が1本まっすぐ引き出されている挿絵。

前の回で、エラー(うまく動かなかったという知らせ)が出たときの渡し方を見ました。たいていは、それで直ります。

でも、ときには、何度頼んでも直らないことがあります。Claude が「直しました」と言うのに、画面では同じことが起きる。この回では、そこから抜ける方法を見ていきます。

バグ:思ったとおりに動かないところ

作品が、作った人の思いとは違う動きをすることを、バグと呼びます。英語の bug は「虫」という意味で、機械の不具合を、中に入り込んだ虫にたとえた呼び方です。

エラーメッセージが出るバグもあれば、何の知らせもなく、ただ数が違うだけのバグもあります。

佐藤さんが詰まったこと

佐藤さんの「売れ残り帳」で、ときどき、あすの目安の数が、ずれることがありました。Claude に2回直してもらいましたが、まだずれます。

この出来事は、説明のための架空の例です。

再現手順:同じことを、もう一度起こす手順

「ときどき、ずれる」では、Claude も、どこを探せばよいか分かりません。そこで、同じことをもう一度起こすための手順を書き出します。これを、再現手順と呼びます。再現は、もう一度、同じように起こすことです。

佐藤さんは、何度か試して、こう書き出しました。

  1. 豆大福の売れ残りを、+で4にする
  2. 「あすは雨」に印を付ける
  3. 「商店街の行事がある」にも印を付ける
  4. あすの目安が、思っていた数と違う

印を1つだけ付けたときは、合っていました。2つ付けたときだけ、ずれるのです。ここまで分かれば、原因はかなり絞れます。

ノートに鉛筆で書いた手順。目安がずれるとき。1. 豆大福を+で4に。2. 『あすは雨』に印。3. 『商店街の行事』にも印。4. 目安が思った数と違う。その下に、印1つ→合う、印2つ→ずれる!と書かれ、ずれる!に下線がある。
佐藤さんのノート(説明のために作った絵です)。何度か試して書き出した、再現手順。

2回直らなかったら、会話を新しく始める

Claude Code の公式のコツには、こう書かれています。

DOCUMENTATION

“If you've corrected the same thing twice and it's still wrong, a third correction mostly adds to a conversation that already contains two failed attempts for Claude to keep re-reading.”

同じことを2回直してもらって、まだ違うなら、3回目の直しは、うまくいかなかった2回分を含んだ会話に、さらに足すだけになりがちです。Claude はその2回分を読み返し続けることになります。

AnthropicBest practices for Claude Code

同じコツには、会話を新しく始め、分かったことを1つの依頼文にまとめて頼み直すほうが、たいていうまくいく、と続きます。

デスクトップアプリでは、新しいセッション(Claude との、ひと続きの会話)を始めます。Mac なら Cmd キーと N キー、Windows なら Ctrl キーと N キーを一緒に押します。同じ作業フォルダ(作品のためだけのフォルダ)を選べば、作ったファイルは、そのまま残っています。

新しい会話では、こう頼みます。

頼み直しの例
「売れ残り帳」の、あすの目安の計算にバグがあります。

【起きること】「あすは雨」と「商店街の行事がある」の両方に印を付けたときだけ、あすの目安が、思っていた数と違います。1つだけなら合っています。
【再現手順】1. 豆大福の売れ残りを4にする 2. 「あすは雨」に印 3. 「商店街の行事がある」に印 4. 目安を見る
【思っていた数】決まりは次のとおりです。
・売れ残りが3つ以上なら、2つ減らす
・売れ残りが0なら、2つ増やす
・雨なら、1割減らす
・行事なら、2割増やす
【これまで】2回直してもらいましたが、直りませんでした。

直す前に、原因として考えられることを3つ挙げて、どれから確かめるかを教えてください。

この依頼文は、説明のための架空の例です。

最後の「直す前に、原因として考えられることを挙げて」は、第4部の第4回で見た、作る前に計画を見るのと同じ考え方です。いきなり直させず、まず、考えられる原因を聞きます。

何度頼んでも直らないときは、再現手順を書き出し、会話を新しく始めて、分かったことをまとめて頼み直します。

注意

ただし、締め切りの前なら、外すという手もある

ハッカソンには締め切りがあります。締め切りの前の夜に、1つのバグで何時間も詰まるのは、よくあることです。

その機能がなくても、第3部で決めた「使う」の場面が見せられるなら、その機能を外して出す、という判断もあります。外した機能は、「次に足したいこと」として発表で話せます。何を外すかは、第2部の第11回で立てた週の計画に照らして決めます。

次回の問い

佐藤さんの次の疑問です。自分で作るのが大変な機能は、どうやって足せばよいのでしょうか。

参考

Best practices for Claude Code(Claude Code)
2回直らなかったら会話を新しく始める、などのコツ。英語。
code.claude.com · code.claude.com
コラム 詰まったときの抜け方(みんなのVibe Coding)
詰まったときの抜け方を、別の角度から。
AMPL · Web

このレッスンは役に立ちましたか?