AIの無駄な指示と壊れた設定を、/doctor prompt-auditで一掃
Claude CodeやCodexなどのAIエージェントがミスをするたび、今後は同じ間違いをしないよう指示をします。
しかし、そうやって積み重なった指示や検証は、AIモデルが進化すると存在するだけでAIの記憶領域を消費し、新たなミスの原因にもなりえます。
今使っているAIモデルにとって無駄な指示や、古くなった設定を見直してくれるのが、Claude Codeの/doctor prompt-auditです。
この記事では、/doctor prompt-auditでAIの指示と設定をすっきりさせる方法を、ぼくが実際に使った実例とともに解説します。
動画で見たい方はこちら。
使っていないスキルも、説明文が毎回読み込まれてコンテキストを消費する
Claude CodeやCodexなどのAIエージェントは、次の内容を毎回読み込みます。
Claude Codeの公式ドキュメントによると、全く使っていないスキルも、一覧にあるだけで毎回コンテキスト（AIの記憶領域）を消費します。
しかも、スキルの説明文に使える枠はコンテキスト全体の1%までで、溢れた分の説明文は削られます。使わないスキルが多いと説明文の一部が省略され、AIが作業に合ったスキルを選べなくなるおそれがあります。
無駄な指示や矛盾した指示は、1行ずつ「消したら間違えるか」で見直す
スキルの説明文以外にも、指示ファイルやスキルの本文に無駄な指示や矛盾した指示があると、AIのミスやトークン浪費の原因になります。
Claude Codeの公式ドキュメントによると、指示ファイルは長いほど指示が守られにくくなり、矛盾するルールがあるとClaudeはどちらかを任意に選びます。指示ファイルの目安は1ファイル200行未満です。
公式のベストプラクティスは、指示ファイルを1行ずつ「これを消したらClaudeは間違えるか」という観点で見直し、間違えないなら削るよう勧めています。
とはいえ、自分のプロジェクトの指示ファイルやスキルを全て読み、1行ずつAIに必要な指示かを考えるのは、手間がかかりすぎます。
/doctor prompt-auditなら、指示の監査と修正をAIに任せられる
そこで役立つのが、2026年9月25日にリリースされたClaude Codeのバージョン2.1.283で追加された/doctor prompt-auditです。
/doctorは、Claude Codeの環境を点検して直すコマンドです。インストールの重複や、使っていないスキル・プラグインなどを調べます。
prompt-auditを付けると、指示ファイルやスキルなどを監査し、今のAIモデルには不要な指示や古い記述、矛盾する指示を探して直してくれます。どちらも、調査結果を先に報告し、了承を得てから修正します。
こまめに掃除していても、壊れた設定と無駄な指示が見つかった
ぼくは普段からAGENTS.mdやスキルをこまめに掃除していますが、/doctor prompt-auditを試すと、多くの問題が見つかりました。
まず、ぼくのパソコンにはClaude Codeが4つ入っていて、ターミナルでclaudeと打つと、壊れて起動しない版が先に呼ばれるようになっていました。
いつもアプリからClaude Codeを使っているので、全く気づきませんでした。ただ、CodexからClaude Codeを呼び出すときは、毎回この壊れた版を呼び、正しい版を自分で探してから作業していたようです。
さらに、使っていないスキルが5つとプラグインが1つあり、新しい会話のたびに約500トークンを無駄にしていました。
指示の見直しでは、AGENTS.mdの無駄な指示を約18%削り、スキルやドキュメントの古い記述・重複・矛盾なども、合わせて23箇所直してくれました。
修正が多いときは、PR分割の計画を作らせて1つずつ直す
ぼくの場合は修正箇所が大量にあったので、1回で直すのはやめました。修正してよいかの確認には、まとめて直させずに次のように指示しました。
調査結果をドキュメントにまとめ、ドキュメントにはAIエージェントが対応しやすいPR分割計画を含めてPR（プルリクエスト）は、ざっくり言うと作業の単位です。あとは計画をもとに、PR1つ分ずつAIに指示して対応してもらいました。指示は次のように短くてOKです。
@計画書ファイル名 のPR1に対応してAnthropicが公開しているprompt-auditの手順書も、影響の大きい変更は、悪化したときに原因を特定できるよう1つずつ行うことを勧めています。
始めるには、Claude Codeを2.1.283以上に更新する
/doctor prompt-auditは、Claude Codeのバージョン2.1.283以上で使えます。古いバージョンで打ってもエラーにならないので、先にバージョンを確認してください。
確認と更新は、AIに次のように指示すれば任せられます。
Claude Codeのバージョンを確認して、2.1.283未満なら最新版に更新してデスクトップアプリ内のClaude Codeはアプリ側で更新されるため、ターミナル版とバージョンが異なることがあります。
更新できたら、Claude Codeの入力欄に/doctor prompt-auditと打つだけです。
まとめの前に、お知らせを。
公式LINEの友だち追加特典で、無料30分相談を受付中。オンライン（顔出し不要）で、AI活用のお困りごとに答えます。
友だち追加後、「相談」と送ると予約リンクが届きます。余裕がなくなったら締め切るので、お早めにどうぞ。
はたらクラフト公式LINELINElin.ee
無料メルマガで実務で使えるAI活用を毎日配信中。1分で登録できます。
超実践AI論Substacktaichiaiworker.substack.com
まとめ：/doctor prompt-auditでAIの指示と設定を最適化
この記事の要点は次の4つです。
- AIエージェントは指示ファイルやスキルの説明文を毎回読み込み、使っていないスキルもコンテキストを消費する
- 無駄な指示や矛盾した指示は、AIのミスとトークン浪費の原因になる
/doctor prompt-auditなら、指示の監査と修正をAIに任せられる- 修正が多いときは、PR分割の計画を作らせて1つずつ直す
あなたのプロジェクトにも、今のAIモデルには不要な指示や矛盾、重複があるはずです。Claude Codeを2.1.283以上に更新して、/doctor prompt-auditを試してみてください。
プロジェクト全体がすっきりして、AIエージェントの動きが良くなり、無駄なトークンの消費も抑えられます。
この記事をシェア
