IntelliJ IDEAで「AIエージェント型開発」を極める：コードを書く時代から、コードを「指揮」する時代へ
かつて、コーディングとは「指先でロジックを紡ぐ作業」でした。しかし、今のIntelliJ IDEAは単なるIDEではありません。貴方が「何を成し遂げたいか」を理解し、プロジェクト全体を俯瞰して実装を代行する「シニアエンジニアの右腕」へと進化しました。
本稿では、JetBrains AI Assistantを単なるオートコンプリートとしてではなく、「複雑なリファクタリングを完遂するAIエージェント」として使い倒すための、現場の極意を伝授します。
—
1. AIを「迷わせない」ための文脈注入（Context Injection）の極意
AIのハルシネーション（もっともらしい嘘）は、多くの場合、AIがプロジェクトのコンテキストを正確に把握できていないことに起因します。AIアシスタントに指示を出す際、ただ「この関数をリファクタリングして」と投げかけるのは素人のやり方です。
プロンプトエンジニアリングの現場解：`@` 記法の活用
AIアシスタント（`Alt + Enter` または `Cmd + K`）を呼び出す際、必ず対象のファイルやクラスを `@` で指定してください。
実戦的なプロンプト例：
> 「@ServiceA.java の複雑なトランザクション処理を、@RepositoryB.java のインターフェースを利用する形にリファクタリングして。特に、チェック例外の変換処理を @ExceptionHandler.java のルールに従って共通化し、呼び出し元の @ControllerC.java に影響が出ないよう、DIのライフサイクルを維持して。」
このように、「役割」「制約」「影響範囲」を明示することで、AIはIDEのPSI（Program Structure Interface）を解析し、単なるテキスト変換ではなく、抽象構文木（AST）レベルで正確な修正案を提示します。
—
2. 開発スピードを加速させる「隠れた」ショートカットとプラグイン
生産性は「IDEに触れる時間」をどれだけ減らすかで決まります。
必須の隠れショートカット
- `Shift + Shift` (Search Everywhere) + `AI`: AI設定やAIリクエスト履歴へ即座にジャンプ。
- `Alt + Enter` (Context Action) -> `AI Actions`: 選択したコードに対する「Explain Code」「Find Problems」「Generate Unit Tests」のショートカットを自分好みにキー割り当て（例: `Ctrl + Shift + A`）しておくことで、マウスレスな開発が可能になります。
生産性を底上げする「神プラグイン」
1. Key Promoter X: どんな操作もショートカットで完結させるための強制学習ツール。
2. GitToolBox: AIで生成したコードの差分を、どのコミットが変更したか、誰が触ったかをインライン表示。AIの提案が過去の慣習と衝突していないか即座に判断できます。
3. SonarLint: AIが生成したコードに対して、静的解析を即座に走らせます。AIの提案を「そのままコミット」する前に、脆弱性や複雑度をチェックする安全弁です。
—
3. 設定の共有化：チームの「知」をコード化する
チーム開発で個人の環境設定がバラバラなのは、組織的な負債です。IntelliJの設定は `.idea` フォルダに格納されますが、これをGit管理下でどう運用するかが鍵です。
推奨：`.idea/` のベストプラクティス構成
`vcs.xml` や `workspace.xml` を除外し、チームで共有すべき設定のみをコミットします。
また、`inspectionProfiles/` を共有することで、CI/CDで動くLintと同じルールをIDE上でリアルタイムに警告として表示させ、AIの修正案がチームの品質基準を満たしているか即座に判定可能にします。
—
4. AIエージェントに「リファクタリング」を指示する際のチェックリスト
AIを真のエンジニアとして扱うために、以下のルールを守ってください。
1. スモールステップ法: 一気に巨大なクラスを修正させず、メソッド単位、インターフェース単位で依頼する。
2. 差分確認を怠らない: `Cmd + D` (Compare) を使い、AIが生成したコードが既存のビジネスロジックを破壊していないか（特に暗黙的な副作用）、必ず目視で確認する。
3. テスト駆動AI: 「修正案を出して」ではなく、「この修正に伴うJUnit 5のテストコードを、モックを適切に使って作成し、その後にコードを修正して」と指示する。これにより、AIに品質保証の意識を強制できます。
—
最後に：テックリードからの提言
AI時代において、優秀なエンジニアとは「コードが書ける人」ではありません。「AIに対して適切なコンテキストを渡し、AIの出力したコードの正当性を瞬時に判断できる審美眼を持つ人」です。
IntelliJ IDEAは、その審美眼を最大限に活かすための最高級の武器です。まずは、今日から「手で書く」前に「AIに考えさせる」時間を10分作ってみてください。その10分が、貴方のチームの開発サイクルを数倍に加速させるはずです。
さあ、IDEを相棒に、創造的な仕事へ戻りましょう。