コース一覧
Claude Code入門
バグ修正を任せる

Claude Code入門

AIコーディングエージェント「Claude Code」への指示の出し方、生成コードの読み方とレビュー、テストと安全確認、バグ修正から機能追加までの実践ワークフローを、毎レッスン実際にエージェントと開発しながら学びます。入門で自分が書いたおこづかい帳を、AIと一緒に機能拡張していきます。

1
Claude Codeとは
01. AIエージェントとは5分
02. 起動と最初の対話5分
03. はじめての指示5分
04. 動きのしくみ5分
05. つくる:最初の一巡6分
06. 第1章クイズ5分
2
基本操作
01. コードについて質問する5分
02. 修正を依頼する5分
03. 差分を読む6分
04. 動かして確かめる5分
05. 元に戻す5分
06. つくる:操作の一巡6分
07. 第2章クイズ5分
3
良い指示の出し方
01. 要件の伝え方5分
02. 受け入れ条件6分
03. タスクを分割する6分
04. 計画させてから実行6分
05. CLAUDE.mdを書く6分
06. つくる:指示の型6分
07. 第3章クイズ5分
4
レビューと安全
01. 生成コードを読む6分
02. 自分で試験する6分
03. テストを書かせる6分
04. 危険な操作の見極め6分
05. 修正の往復6分
06. つくる:レビュー一巡7分
07. 第4章クイズ5分
5
実践ワークフロー
01. バグ修正を任せる6分
02. 機能追加を任せる6分
03. リファクタを任せる6分
04. ドキュメントを書かせる6分
05. 知らないコードを解説させる6分
06. つくる:ワークフロー実践7分
07. 第5章クイズ5分
6
総合制作
01. 大型機能を共同実装8分
02. 総レビュー7分
03. 任せる/書くの境界6分
04. 自由拡張8分
05. 完成と次のステップ5分

バグ修正を任せる

バグ報告は3つで書く

バグ修正を AI に任せるとき、「動きません」だけでは直りません。人間の同僚に頼むときと同じで、必要なものは3つです。

プレーンテキスト

再現手順 どう呼んだら起きるのか 期待 本当はどうなってほしいのか 実際 いまどうなっているのか

この3つが揃うと、AI は原因を探す範囲を絞れます。逆に1つでも欠けると、AI は「たぶんこういうことだろう」と推測で埋めて、別のところを直しはじめます。

悪い報告と良い報告

プレーンテキスト

悪い 合計がおかしいので直して

これでは、何が「おかしい」のか分かりません。金額がずれているのか、エラーで落ちるのか、順番が違うのか。AI は当てずっぽうで手を入れることになります。

プレーンテキスト

良い kakeibo.py の total_by_category を [{"category": "食費", "amount": 300}] で呼ぶと {} が返ります。{"食費": 300} が返るはずです

入力そのものを書いているのが要点です。再現できる入力を渡せば、AI は自分で動かして確かめられます。

原因を先に決めつけない

つい「たぶんループの条件が悪いので直して」と書きたくなります。しかしその推測が外れていると、AI は間違った場所を熱心に直します。

プレーンテキスト

避ける ループ条件がおかしいので直して 良い この入力でこうなる。原因を調べて直して

原因の特定は AI の得意分野です。症状だけを正確に渡して、原因の推定は任せるほうが速く直ります。原因に心当たりがあるなら、「〜かもしれません」と参考情報として添える程度にとどめます。

直ったことの確かめ方

修正が返ってきたら、報告に書いた再現手順をそのまま実行します。ここで直っていなければ、まだ終わりではありません。

もう1つ大事なのは、壊れていなかったところが壊れていないかです。バグ修正は既存の動作を巻き添えにしがちです。空のリストを渡したとき、複数件を渡したときなど、周辺も一度は動かしてください。

今回の演習

おこづかい帳の集計にバグを仕込んであります。カテゴリごとの合計を出す関数ですが、同じカテゴリが複数回出てくると、最後の1件だけが残って前の分が消えます。

再現手順と期待と実際の3つを書いて、AI に直させてください。

完成条件

  • 触ってよいのは kakeibo.py だけです
  • 再現手順と期待と実際の3つを指示に含めてください
  • total_by_category 関数の戻り値で採点します

依頼

kakeibo.py の total_by_category にバグがあります。同じカテゴリが複数あると合計されず、最後の1件だけになります。再現手順を添えて直してください。

  • ・触ってよいのは kakeibo.py だけです
  • ・再現手順と期待と実際の3つを指示に含めてください
  • ・total_by_category 関数の戻り値で採点します

いまのコード

kakeibo.py

def total_by_category(records):
    """カテゴリごとに金額を合計する"""
    result = {}
    for r in records:
        result[r["category"]] = r["amount"]
    return result

AI への指示

残り 3 回
AI に依頼するにはが必要です

ヒント