概要
https://qiita.com/teramika/items/baa17a9901448cc0072a
詳細内容
## AI駆動開発の課題点をGemini3.0に解決してもらう
https://qiita.com/teramika/items/baa17a9901448cc0072a
新卒エンジニアがAI駆動開発で直面する学習機会の損失とコード品質判断の課題に対し、VS Code拡張機能「@study」エージェントが自動で詳細な実装解説ドキュメントを生成する解決策を提示します。
**Content Type**: ⚙️ Tools
**Language**: ja
**Scores**: Signal:4/5 | Depth:4/5 | Unique:4/5 | Practical:5/5 | Anti-Hype:4/5
**Main Journal**: 86/100 | **Annex Potential**: 84/100 | **Overall**: 84/100
**Topics**: [[AI駆動開発, 新卒エンジニア教育, VSCode拡張機能, コード解説自動生成, Gemini]]
AIエージェントによる自動コード生成が当たり前となる中で、筆者は新卒エンジニアがAI駆動開発において直面する二つの大きな課題を指摘します。一つは、自身で技術選定やロジック構築、エラー修正を行う機会が失われ、コーディングスキルが身につかないこと。もう一つは、開発経験の浅さからAIが生成したコードの正誤判断が難しく、知らないうちに品質の低いコードを取り入れてしまうリスクです。
これらの課題に対し、エージェントを完全に使わない選択肢は現実的ではないとし、AIが生成したコードの実装内容をAI自身に詳しく解説させる方法を提案します。さらにその効率化のため、未コミットのGit差分をAIによる実装とみなし、その内容を自動で詳細に解説するドキュメントを生成するVS Code拡張機能「@study」を開発しました。
この「@study」エージェントは、現在の作業ディレクトリと最新コミットとの差分を読み取り、関連ファイルの全コードをコンテキストとしてGemini 3.0に渡します。そして、「コード設計の意図を可視化する専門家」という役割を与えられたAIが、新卒エンジニア向けの実装結果解説ドキュメントをMarkdown形式で自動生成します。このドキュメントには、Mermaid記法を用いたアーキテクチャ・マップ、新規導入されたクラス名や関数名などの用語集、そして「派生データ（Derived State）」の活用やロジック分離（Custom Hookへの委譲）といったReactのベストプラクティスとAIの設計意図を関連付けた解説が含まれます。
実際にGemini 3.0と2.5で生成されたドキュメントを比較すると、3.0は実装ベースの解説に加え、体系的な知識習得を促すような解説に優位性があることが示唆されました。筆者は、このツールを活用することで、新卒エンジニアがAIエージェントによる開発を進めながらも、コードの理解を深め、スキルを習得できるようになると強調しています。