AI にプログラム診断してもらう方法｜初心者でもプロ級チェック

AI にプログラムの診断をしてもらうって、聞いたことありますか？

「AIにプログラムを見てもらって、問題を指摘してもらう」という話、最近よく聞きますよね。でも実際にやってみると、「変数名を変えて」くらいの浅いアドバイスしかもらえないことが多いんですよ。

今日は、Googleが社内で使っている診断基準を AI に教える方法をお話しします。これをやると、まるでベテランエンジニアがチェックしてくれたような、深い指摘がもらえるんです。

Claude Code（AI の診断ツール）に「このプログラムを診断して」と頼むと、確かに何かしら指摘は返ってきます。でも、その内容にバラつきがあるんですよ。

これって職場に例えると、新人さんに「この資料チェックして」と頼んだときと同じ状況なんです。何をチェックすべきかの基準が分からないから、表面的な指摘しかできないってことなんです。

一方、ベテランの先輩に頼むと「ここの設計に問題がある」「この部分が将来トラブルの元になりそう」といった、的確な指摘がもらえますよね。

💡 初心者メモ: AI も人と同じで「何を見るべきか」を教えてあげると、グッと診断の質が上がるんです

Googleは自社のエンジニアが使っている「プログラム診断の8つのポイント」を公開しているんです。これを AI に教えてあげると、診断の質が劇的に変わります。

その8つのポイントがこちらです：

この順番も重要で、上から順に大切な項目になっているんですよ。

8つの項目で網羅的にチェックするので、重要な問題を見逃すリスクが大幅に減ります。職場でいうと、チェックリストを使って確認作業をするイメージですね。

Google の基準では「設計 > 機能性 > 複雑さ」の順で重要度が決まっています。AI はこの順番で指摘してくれるので、どの問題から直すべきかが一目瞭然なんです。

表面的な指摘だけでなく、「このままだと後で困りそうな部分」まで教えてくれます。優秀な先輩が将来を見越してアドバイスしてくれる感じですね。

💡 初心者メモ: プログラムの問題は早く見つけるほど、修正コストが安く済みます

Google が公開している「Engineering Practices Documentation」を確認します。「Google engineering practices」で検索すると見つかりますよ。

Claude Code のプロジェクト設定ファイル（CLAUDE.md）に、以下の内容を追加します：

「この8つの基準でプログラムを診断してください」と AI に依頼すると、格段にレベルの高い診断結果が返ってきます。

💡 初心者メモ: 一度設定すれば、そのプロジェクトではずっと高品質な診断が受けられます

Google の基準でも「完璧なプログラムではなく、改善をもたらすプログラム」を良しとしています。100点を目指すより、今より良くなることを大切にしましょう。

AI には一度に処理できるプログラムのサイズに限界があります。大きなプログラムは、機能ごとに分けて診断してもらうのがコツです。

⚠ 注意: AI の診断はあくまで「参考意見」です。最終的な判断は必ず人間が行いましょう

プログラミング初心者でも、この方法を使えばベテランエンジニア並みの品質チェックができるんです。ぜひ試してみてくださいね。

もっと詳しく知りたい方はこちら

この記事の元になった詳細版をnoteで公開しています。
コード例・設定ファイル・応用テクニックなど、実践的な内容が満載です。

Claude Codeをクラウドで動かすなら

ConoHa VPSは時間課金から使えるVPSサービス。Claude Codeの実行環境をクラウドに構築したい方、ローカルAIを試したい方に最適です。最小構成なら月数百円から始められます。