コードとデバッグでの AI の活用

AI コーディングアシスタントは、境界のあるエンジニアリングループ内で最も有用です。問題を理解し、小さな変更を提案し、チェックを実行または説明し、証拠に基づいて修正します。判断を置き換えるのではなく、加速させるべきです。

コーディングアシスタントに適したタスク

レビューが現実的なタスクに AI を使いましょう。

• 関数やエラーメッセージの説明。
• 期待される挙動からユニットテストの下書き。
• 小さなリファクタリングの提案。
• 実装オプションの比較。
• 既存コードからのドキュメント生成。
• 失敗するテストの考えられる原因の特定。

要件や検証なしに、大きく曖昧なタスクを丸ごと任せるのは避けてください。

デバッグプロンプトパターン

デバッグでは次を提供してください。

• 期待していたこと。
• 実際に起きたこと。
• 最小限の関連コードスニペット。
• 正確なエラーメッセージ。
• 問題を再現する入力。
• すでに実行したテストやコマンド。

そのうえで、考えられる原因、最小限の修正、検証ステップを求めてください。

AI コーディングループ

日常のコーディング作業ではこのループを使いましょう。

1. 問題を説明し、考えられる原因を求める。
2. 最小限の安全な変更を求める。
3. 変更を自分で適用または検査する。
4. テスト、型チェック、リンター、または焦点を絞った手動チェックを実行する。
5. さらに反復が必要な場合のみ結果をフィードバックする。

これにより、アシスタントを制御されたループ内に保ち、1 つのプロンプトから大きな未レビューのパッチに発展させません。

ガードレール付きリファクタリング

リファクタリングを依頼するとき、変更してはいけないものを伝えてください。公開 API、出力形式、データベーススキーマ、アクセシビリティ挙動、パフォーマンス制約など。ガードレールがないと、AI は契約を変えながらコードを「改善」するかもしれません。

生成コードをパッチとしてレビューする

生成コードを見た目の洗練さで判断しないでください。他のパッチと同様にレビューしてください。正しさ、エッジケース、セキュリティ、依存関係の変更、可読性、テストです。

手動検査に切り替えるタイミング

アシスタントが同じ失敗した修正を繰り返す、無関係な書き換えを導入する、依頼なく公開挙動を変える、結果の検証方法を説明できない場合は、AI ワークフローを一時停止してください。その時点でコードを検査し、問題を縮小し、より小さなプロンプトで再開してください。

重要なポイント

• AI は小さくレビュー可能なコーディングループで最も強力です。
• デバッグプロンプトには症状、再現手順、期待される挙動を含めるべきです。
• 生成コードにもテストとレビューが必要です。
• AI が変更範囲を拡大し始めたら停止し、タスクを絞ってください。

次のレッスン

次は、AI の回答を信頼する前に確認する繰り返し可能な方法を学びます。