Claude prompt-auditの使い方。指示の監査と適用を分ける

この記事でわかること

• 準備：監査するファイルと対象モデルを明示する方法。
• 見方：報告書の場所・根拠・確信度と、提案差分を照合するポイント。
• 判断：業務固有の条件を残し、変更不要という結果も受け入れる基準。
• 適用：採用した差分だけを反映し、代表的な仕事で確認する流れ。

公式prompt-auditは、何を返すのか

公式の claude-api スキルでは、/claude-api prompt-audit が既存のプロンプト、ツール説明、Skills、エージェントの設定用指示ファイルを点検する入口として案内されています。まず対象とモデルの前提を定め、対象一覧と指示の由来を確認し、古い記述や矛盾を探す流れです。公式スキルのサブコマンド一覧

受け取るものは、理由を説明する監査報告と、実際の変更案を表す提案差分の二つです。報告だけでは直し方が曖昧になり、差分だけでは削る理由が分かりません。両方を並べて読むことが、この手順の使いどころです。公式prompt-audit手順

使う前に、スキルが導入されているか確かめる

このコマンド名が、どのClaude Code環境にも最初からあるとは限りません。公式リポジトリにはプラグインとしてSkillsを導入する方法が示されています。利用中の環境で claude-api スキルが使えるか、導入元が公式かを確認してから進めてください。会社管理の環境では、社内の導入手順に従います。Anthropic Skillsの導入案内

1ファイルから、根拠のある差分を受け取る

1．対象ファイルとモデルを指定する

最初は、作業フォルダー内の CLAUDE.md など一つの対象に絞ると結果を読みやすくなります。公式手順は、依頼で対象が指定されなければ作業ディレクトリの指示群を対象にし、範囲やモデルの前提を報告へ記載して進める設計です。毎回、質問で立ち止まってくれるとは考えず、最初の依頼に範囲を書きます。対象とモデルを決める手順

以下は依頼文の例です。角括弧の部分を自分の環境に合わせて置き換えます。対象モデルは、監査対象の指示を実際に使うモデル名です。

claude-api スキルの prompt-audit を使って、次の指示ファイルを監査してください。
対象ファイル：【この作業フォルダー内の CLAUDE.md のパス】
対象モデル：【実際にこの指示を使うモデル名】
今回は監査報告と提案差分の作成までです。ファイルは変更しないでください。
各指摘について、場所、根拠、変更理由、確信度を示してください。業務固有の条件と、指示を追加した理由を失わないようにしてください。
指定外のファイルやユーザー共通設定への変更は提案差分に混ぜず、必要なら別の確認事項にしてください。

実行前の版はGitのコミットや作業コピーで残しておきます。これは監査で何かを削るためというより、後から同じ条件へ戻せるようにするためです。自分の修正途中の内容がある場合は、監査前からの差分と混ざらないように分けます。

2．「なぜ書かれたか」を、変更理由と一緒に読む

公式手順は、履歴がある場合に指示の出所を調べ、どの失敗を防ぐために加えられたかを確認します。また、業務の事情、品質条件、ツールの扱い方、制約の理由を、単なる余分な文章として削らないよう区別しています。指示の出所と保持対象

たとえば「社外送付前に責任者へ確認する」という一文は、文章の書き方の好みとは違います。「強い表現が多いから削除」という提案になっていたら、送付に関する社内判断を失っていないか読み直します。表現を穏やかに直す場合でも、承認の必要性まで弱めないことが大切です。

3．報告書の場所と、差分の変更箇所を合わせる

監査結果を読む際は、まず「どこを変えるか」、次に「何と矛盾しているか」、最後に「変更後に何が残るか」を確認します。以下は実際の監査ログではなく、判断の練習用に作った例です。

ファイル名や行番号が示されても、それだけで理由が正しいとは限りません。「存在しない」とされたファイルが、まだ生成前の成果物だったという場合も考えられます。削除の提案を採用する前に、現在の運用と照合します。

4．変更がないときは、無理に差分を作らせない

公式手順では、問題が見つからない対象に変更を加えないことも正しい結果です。不確かな指摘は報告に残し、変更案から外す扱いが示されています。変更不要と不確かな指摘の扱い

「せっかく監査したのだから短くしたい」と考えると、必要な条件まで削りがちです。レビューの終了条件を、削除行数ではなく、対象範囲の確認と、指摘に対する採用・見送りの判断が済んだことにしておくと整理できます。

承認した差分だけを適用し、仕事で確かめる

公式スキルは、編集を明示的に依頼されていない監査では変更を適用せず、提案を返す設計です。ただし、これはスキルの指示内容であり、ファイルの書き込みを技術的に封じる保証ではありません。実行環境の権限と、変更履歴の確認も併用します。prompt-auditの適用条件

採用するときは「報告の1番だけを適用し、2番は保留」のように指定します。その後、いつも使う短い仕事を同じ入力で試し、必要な根拠、出力形式、承認待ちの位置が変わっていないかを見ます。複数の変更を一度に適用すると、結果が悪くなったときに原因を戻しにくくなります。

費用への効果を見る場合も、文字数だけで結論を出さないようにします。Anthropicの別のコスト最適化ガイドは、完成した仕事あたりの費用と品質を一緒に見る考え方を示しています。再試行や手直しが増えれば、短い指示でも運用全体の負担は減らない可能性があります。公式コスト最適化ガイド

実務上の注意

指示ファイルの監査と、認証情報や接続設定の点検は分けてください。公式監査手順も、秘密情報を含み得る設定・認証ファイルを無差別に読むことを避けています。依頼する際は、APIキーや個人情報を監査資料として添付しないようにします。

また、ユーザー共通の設定を変えると、今回のプロジェクト以外へ影響する可能性があります。最初の監査は対象フォルダー内に限定し、共通設定の見直しが必要なら別件として影響範囲を確認しましょう。

まとめ

Claude prompt-auditを使うときは、対象ファイルとモデルを決め、報告の根拠と提案差分を対にして確認します。残すべき業務条件を守りながら、採用した変更だけを反映し、普段の仕事で確認するところまでを一組にしましょう。

毎回読み込む情報の量そのものが気になる場合は、常設ルールと参照資料を分ける考え方も参考になります。今回の監査は、その整理とは別に、具体的な記述が今の環境と矛盾していないかを確かめる入口です。

よくある質問

出典・参考情報

• Anthropic Skills：prompt-audit 公式手順
• Anthropic Skills：claude-api スキルとサブコマンド
• Anthropic Skills：Cost Optimization
• Anthropic Skills：導入案内

確認日：2026年11月9日（日本時間）。公開スキルは更新されるため、利用時の版と実行環境を確認してください。