売店のレジのバグ
学校の売店には、買い物かごの合計を出す小さなプログラムがあります。生徒がポテトチップスとジュースとりんごを買うと、レジは 35p と言います。これは間違いです。コードを読んで、自分でバグを見つけることもできます。今日は、AI コーディングエージェントに手伝ってもらい、その仕事を自分で確かめます。
このレッスンの終わりには
メモ
コーディングエージェントを使ってバグを直し、その修正を自分で確かめることができる。
キーワード
- コーディングエージェント：あなたの代わりにコードを読んだり、変更したりするプログラム。
- モデル：エージェントの答えを書く AI。
- プロンプト：エージェントにしてほしいことを伝える文。
- テスト：コードが正しい答えを出すかを調べる小さなプログラム。
- 許可：エージェントが何かを変える前に、あなたに確認すること。
はじめる前に
メモ
このレッスンの上にあるバーのラボを起動を押して、動いていると表示されるまで待ってください。ラボは agent というサービス1つで、ターミナルはその名前でつながります。下の実行ボタンを押すと、コマンドが順番に、同じセッションのラボのターミナルへ入力されます。実行の様子を見たり、自分でコマンドを打ったりするときは、バーのターミナルを開く（新しいタブ）を押します。
1. エージェントは準備できている？
エージェントは、ラボを起動するたびにインストールされます。インストール中は installing と表示され、終わると ready と表示されます。ready になるまで、何度か実行してください。
docker exec agent cat /tmp/agent/statusここでは表示のみで、実行されません。無料アカウントを作成すると、実行ボタンで自分のラボのターミナルに入力できます。
2. まずテストを実行する
だれかが何かを変える前に、何が悪いのかを調べます。このプロジェクトには5つのテストがあります。4つは成功し、1つは失敗します。a basket adds up は 180 を期待したのに、35 でした。どのテストが失敗したか、書き留めておいてください。あとで必要になります。
docker exec -w /home/node/project agent node --testここでは表示のみで、実行されません。無料アカウントを作成すると、実行ボタンで自分のラボのターミナルに入力できます。
3. エージェントに説明してもらう
エージェントは、プロジェクト全体を読めます。ここでは質問だけをして、ほかには何もしません。opencode run は質問を1つして、答えを表示します。読んでみましょう。ループが最後の値段しか残していないことに、気づいていますか。
docker exec -w /home/node/project agent opencode run "Explain what the total function in shop.js does, in three short sentences. Do not change any file."ここでは表示のみで、実行されません。無料アカウントを作成すると、実行ボタンで自分のラボのターミナルに入力できます。
よくある間違い
注意
エージェントの答えは自信ありげだから、きっと正しいと考える人は多いです。でも、エージェントは間違っていても、自信ありげに聞こえることがあります。変更を信じていいのは、自分でテストを実行し、変えられた行を自分で読んだときだけです。
4. あなたの許可のもとで、エージェントに直してもらう
このコマンドは、エージェント専用の画面をターミナルに開きます。次のように入力してください。Fix the bug in total in shop.js so the tests pass. Do not change shop.test.js. エージェントがファイルの変更を許可してほしいと聞いてきたら、先に変更内容を読んでから、許可します。終わったら、Ctrl+C を2回押して閉じます。
docker exec -it -w /home/node/project agent opencodeここでは表示のみで、実行されません。無料アカウントを作成すると、実行ボタンで自分のラボのターミナルに入力できます。
5. 自分で確かめる
もう一度テストを実行します。5つすべてが成功するはずです。そのあと、レジを動かします。ポテトチップスとジュースとりんごのかごは £1.80 になり、£5 から出るおつりは £3.20 になるはずです。
docker exec -w /home/node/project agent node --testここでは表示のみで、実行されません。無料アカウントを作成すると、実行ボタンで自分のラボのターミナルに入力できます。
docker exec -w /home/node/project agent node shop.jsここでは表示のみで、実行されません。無料アカウントを作成すると、実行ボタンで自分のラボのターミナルに入力できます。
答えてみよう
- 修正の前に失敗したのはどのテストで、何を期待していましたか。
- エージェントはどの行を変えましたか。古い行はなぜ間違っていましたか。
- エージェントが終わったと言ったあと、なぜ自分でもテストを実行したのですか。
- プロンプトに、絶対に入力してはいけないものは何ですか。
先生へ
ヒント
このレッスンは、ラボで進めるレッスンの小さな例です。手順と実行ボタンがレッスンで、ラボは生徒一人ひとりのコピーです。ラボは、サービス1つと、そのそばにある AI コーディングエージェントでできていて、モデルはプラットフォームのもので、ロンドンにあります。学習のポイントは3つです。1. エージェントは、あなたの代わりにコードを読んだり変更したりする。2. どんな変更の前後にも、テストを実行する。3. 許可する前に、すべての変更を読む。エージェントが自信ありげだからと信じてしまう生徒の間違いに気をつけて、生徒の発言に耳を傾けてください。そういう生徒には、テストが成功している画面を見せるように言ってください。生徒は、修正の前後のテスト結果、変えた行、そして質問への答えを提出します。自分のモジュールにコピーして変更するか、レッスンビルダーのラボメニューから最初から作ってください。