概要
https://zenn.dev/rescuenow/articles/3b82a651794d4c
詳細内容
## AIエージェントへの指示、実際どうしてる？
https://zenn.dev/rescuenow/articles/3b82a651794d4c
著者は、AIエージェント「Claude Code」を活用した実際の開発タスクにおいて、AIが直面した課題を具体的な指示でいかに解決し、最終的な成功に導いたかを詳細な事例を通じて提示します。
**Content Type**: Tutorial & Guide
**Language**: ja
**Scores**: Signal:4/5 | Depth:4/5 | Unique:4/5 | Practical:5/5 | Anti-Hype:5/5
**Main Journal**: 89/100 | **Annex Potential**: 88/100 | **Overall**: 88/100
**Topics**: [[AIエージェント, プロンプトエンジニアリング, AIを活用した開発, デバッグ戦略, Claude Code]]
この記事では、著者が「Claude Code」を用いて、既存の情報選択画面の表示ロジックを修正する開発タスクに取り組んだ実践例を詳述しています。未経験のJava/VB.NETコードベースで、修正箇所がバックエンド、フロントエンド、データベースのどこにあるか不明な状況から、AIエージェントと共にタスクを遂行する過程が示されます。
著者は、最初にマークダウンファイルに具体的な指示をまとめる方式を採用。期待する画面表示、既存の類似処理（鉄道カテゴリ）の参照、エンコーディングの問題からAIにはコードの修正箇所とコード提示のみを求め、実装計画の立案も依頼しました。この詳細な指示に対し、Claude CodeはフロントエンドのVB.NETファイルの修正を提案。しかし、この修正では選択内容の一時的な表示は変わるものの、保存後に再度開くと変更が失われる問題が発覚しました。
この問題の原因究明において、Claude Codeはフロントエンドのデバッグやデータベースのカラム追加といった的外れな提案を繰り返し、「負のループ」に陥ります。著者はこの状況を打破するため、「なぜそう考えたか」ではなく「選択内容を表示する処理がどのファイルに記載されているか調査してください」と事実ベースの調査を依頼。これにより、問題の根源がバックエンドにあることが判明し、無事修正に至りました。
この経験から、著者はAIエージェントへの効果的な指示出しのコツを強調しています。具体的には、テキストだけでは伝えにくい変更内容には現状と期待するイメージ画像を併用すること、既存の類似処理を参考にさせること、そして「フロントエンドで表示されない」といった漠然とした指示ではなく「〇〇を表示する処理の実装箇所を調査し、●●と表示されるように修正してください」のように、具体的な調査範囲と期待結果を明確に伝えることの重要性を説きます。AIが的外れな提案を始めた場合は、仮説ではなく事実に基づいた調査を求めることが有効だとしています。
この事例は、AIエージェントが万能ではなく、特に複雑なコードベースやデバッグ作業においては、人間の適切なガイドと、AIの思考の「負のループ」を断ち切るプロンプトエンジニアリングのスキルがいかに重要であるかを示しています。