コース一覧
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点セット

第1章で「対象と変更を分けて書く」を学びました。実際に既存コードを直させるときは、もう1つ足します。

プレーンテキスト

対象 どのファイルの、どの関数を 現状 いまどうなっているか 変更後 どうなってほしいか

真ん中の現状が新しく増えた要素です。これがあると、AI は「自分が読んだコード」と「依頼者が思っているコード」が同じかどうかを突き合わせられます。ズレていれば、書き換える前に指摘が返ってきます。

プレーンテキスト

悪い kakeibo.py の合計を直して 良い kakeibo.py の sumAmount は、いま全部の支出を足しています。 これを、金額が0より大きいものだけ足すように変えてください。

変えてはいけないものを書く

修正依頼でいちばん事故が多いのは、頼んでいない部分が一緒に変わることです。

プレーンテキスト

関数名は変えないでください。引数の順番も変えないでください。

この一文が無いと、AI は良かれと思って名前を英語らしく整えたり、引数を辞書にまとめたりします。それ自体は改善かもしれませんが、その関数を呼んでいる他の場所が全部壊れます。

呼び出し側から見える形は固定する。 これを毎回書くと決めておくと安全です。

境界の扱いを決める

条件を足す依頼では、境界をどちらに入れるかを必ず書きます。

プレーンテキスト

曖昧 マイナスを除いて 明確 0以下を除いて。0ちょうども除いてください

「0より大きい」と「0以上」は1文字違いですが、結果は変わります。書かなければ AI が決めます。決められた側は、テストで落ちて初めて気づきます。

1回の依頼で1つ変える

プレーンテキスト

悪い 合計をマイナス除外にして、ついでに表示も整えて、関数名も分かりやすくして 良い 合計をマイナス除外にしてください

3つ頼むと、差分が3つ混ざって返ってきます。1つ目は正しく、2つ目が間違っていたとき、部分的に採用する手段がありません。全部やり直すことになります。

1依頼1変更にすると、差分が小さくなり、判断が速くなり、失敗しても捨てる量が少なくて済みます。次の回では、その差分をどう読むかを扱います。

完成条件

  • 触ってよいのは kakeibo.py だけです
  • 0ちょうどと、0より小さい金額は合計に入れません
  • sumAmount 関数の戻り値で採点します

依頼

kakeibo.py の sumAmount を、金額が0より大きい記録だけを足すように変えてください。関数名と引数は変えないでください。

  • ・触ってよいのは kakeibo.py だけです
  • ・0ちょうどと、0より小さい金額は合計に入れません
  • ・sumAmount 関数の戻り値で採点します

いまのコード

kakeibo.py

def sumAmount(records):
    """おこづかい帳の金額を合計する"""
    total = 0
    for r in records:
        total += r["amount"]
    return total

AI への指示

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

ヒント