/doctor prompt-auditとは、古いモデル向けの指示を洗い出すClaude Codeの点検機能のことです。
商品説明文の生成、楽天RMSから書き出したCSVの整形、問い合わせの分類。こうしたEC業務をClaude Codeに任せている会社では、CLAUDE.md(Claude Codeが毎回最初に読む指示書)やスキル(業務手順をまとめた指示ファイル)が、半年、1年と継ぎ足されて長くなっているはずです。その中には、昔のモデルの癖に合わせて書いた「必ず」「絶対に」「IMPORTANT」の連打や、今は存在しないファイルへの参照が残っています。2026年9月25日公開のClaude Code 2.1.283で追加された「/doctor prompt-audit」は、こうした古い書き方を洗い出す機能です。本記事は、EC支援19年・5,000社超の実績を持ち、AI導入支援は2023年から提供する株式会社オルセル(うるチカラ運営)が、EC業務の指示ファイルをこの機能で見直す5つの手順を解説します。
要点を先に書くと、この機能は報告と修正案を出すだけで、ファイルを勝手に書き換えません。楽天市場の店舗運営規約や薬機法に関わる禁止事項のように「理由のあるルール」は残しつつ、強調の連打や矛盾、存在しない参照を整理する。その判断を人が行うための材料を、短時間でそろえられるのが価値です。
なぜ今、指示ファイルの見直しが必要なのか
見直しが必要な理由は、モデルが賢くなるほど、昔の書き方が逆効果になり始めているからです。Anthropicは、新しいモデル向けにClaude Code自体のシステムプロンプト(あらかじめ組み込まれた指示)を8割以上削っても、コーディングの評価で目立った低下がなかったと説明していると報じられています(Techstrong.ai)。指示を細かく積み上げるほど良くなる、という前提はもう成り立ちません。
EC業務の指示ファイルで起きやすいのは、3種類の「古さ」です。1つ目は、過剰な強調です。以前のモデルが指示を読み飛ばしがちだった頃に、「絶対に」「必ず」「IMPORTANT」を重ねて書いた名残で、今のモデルでは特定の指示だけが過剰に効いて、ほかの指示とのバランスが崩れる原因になります。2つ目は、矛盾です。CLAUDE.mdでは「商品名は全角60文字以内」、スキルでは「商品名は楽天の上限まで使う」のように、継ぎ足しの過程で食い違った指示が残ります。3つ目は、存在しない参照です。フォルダ構成を変えたのに、古いスクリプト名やファイルの場所が指示に書かれたままになっているケースです。
これらは書いた本人ほど気づきにくいものです。現場で繰り返し見るのは、担当者が交代するたびに指示が追記され、誰も全体を読み直していない指示ファイルです。人が全文を読み直すと数時間かかる分量でも、/doctor prompt-auditなら数分で論点を一覧にできます。
なお、AIへの指示を減らす方向性そのものは、Anthropicが示すプロンプト設計の新常識や、Claude Opus 5.5のプロンプト刷新で見直す論点でも取り上げてきました。/doctor prompt-auditは、その考え方を自社の指示ファイルに当てはめるための道具と位置づけられます。
/doctor prompt-auditでできること・できないこと
この機能でできるのは、Claude Codeが読み込む指示ファイルを読ませ、古いモデル向けの書き方を指摘させ、修正案を受け取ることです。クラスメソッドの検証記事によると、対象はCLAUDE.md、スキル、エージェント(サブエージェントの定義)、コマンドで、引数なしで実行すると、ユーザー単位の設定フォルダ(~/.claude/)にあるファイルも対象になり得ます。「/checkup prompt-audit」という別名でも同じ点検が動きます。
点検の対象外になっているものもあります。同記事では、秘密情報を含む可能性がある設定ファイル(.claude/settings系のJSONや.mcp.json)は読まないとされています。APIキーや接続先が書かれたファイルを点検のために読み込まない設計は、EC事業者にとって安心材料です。
同記事の検証では、意図的に古い書き方を仕込んだ指示ファイルに対して、存在しないパスや存在しないスクリプトの参照、CLAUDE.mdと別のルールファイルの間の矛盾、IMPORTANTやCRITICAL、感嘆符の連打といった過剰な強調、古いモデル向けの言い回しが指摘されました。一方で、理由が書かれた禁止事項(データベースを初期化するスクリプトを実行しない、など)は残すよう判断されています。何を消し何を残すかを、理由の有無で見分けている点が重要です。
できないことも押さえておきます。この機能はファイルを書き換えません。報告と修正案を出すだけで、適用するには明示的な依頼が必要です。同記事では、「きれいにして」のような大ざっぱな依頼では自動で適用されなかったと報告されています。また、点検の結果は使うモデルによって変わり得るとされています。点検の観点の一覧も公式には列挙されていないため、指摘を鵜呑みにせず、人が1件ずつ判断する前提で使います。
名前の似た「/claude-api prompt-audit」との混同にも注意が必要です。こちらはClaude APIで作ったアプリの中のプロンプトやリクエストのコードを点検するもので、Claude Code自身の指示ファイルを点検する/doctor prompt-auditとは対象が違います。自社でAPIを使った商品説明文の生成ツールを持っている場合は、両方を使い分けることになります。
EC業務の指示ファイルを見直す5つの手順
ここからは、EC業務の指示ファイルを実際に見直す手順を5つに分けて説明します。所要時間は、指示ファイルが10本程度の会社なら、最初の1回で半日程度を見込んでおくと現実的です。
手順1は、対象ファイルの棚卸しとバックアップです。CLAUDE.md、AGENTS.md(複数のAIで共通に使う指示書)、.claude/rules配下のルール、skills配下のスキル、カスタムコマンド、サブエージェントの定義を一覧にします。そのうえで、gitで現在の状態を記録するか、フォルダごと複製してから作業を始めます。修正案を適用したあとで元に戻せるようにしておくことが、すべての前提です。
手順2は、範囲を絞って点検を走らせることです。いきなり全体を点検すると指摘の量が多くなり、判断が雑になります。まずは「/doctor prompt-audit CLAUDE.md」のようにファイルを1つ指定して実行し、指摘の傾向をつかみます。そのあと、商品説明文のスキル、CSV整形のスキル、問い合わせ分類のスキル、というように業務単位で範囲を広げていきます。
手順3は、指摘を4つに分類することです。存在しない参照、矛盾する指示、過剰な強調、古い言い回しの4つです。存在しない参照と矛盾は、ほぼ機械的に直してよい項目です。過剰な強調と古い言い回しは、そのルールに理由があるかどうかで扱いを変えます。楽天市場の店舗運営規約で禁止されている外部誘導や、薬機法・景品表示法で使えない表現の一覧のように、守らないと実害が出るルールは消さず、強調を減らす代わりに「なぜ守るのか」を1文添える書き方に変えます。
EC業務の指示ファイルに当てはめると、4つの分類は次のような例になります。存在しない参照は、「商品マスタは /data/master_2025.csv を読む」と書いたまま、ファイル名を2026年版に変えていたケースです。矛盾は、CLAUDE.mdで「キャッチコピーは全角30文字以内」、楽天向けスキルで「キャッチコピーは楽天の上限まで使う」と書いてあるケースです。過剰な強調は、「【超重要】絶対に絶対に送料無料と書かないこと!!」のような書き方です。古い言い回しは、「深呼吸してから一歩ずつ考えてください」「あなたは世界最高のコピーライターです」のような、昔のモデルの出力を良くするために流行した決まり文句です。
このうち、送料無料の扱いのように実害につながるルールは、「送料無料の条件は商品ごとに異なり、誤表示は景品表示法上の問題になり得るため、商品データに送料無料の記載がある場合だけ書いてください」のように、条件と理由を添えた1文に直します。強調を外しても、守るべき理由が伝われば、新しいモデルはむしろ正確に従います。
手順4は、修正案を確認して明示的に適用することです。修正案の差分を読み、採用するものだけを「この差分の1番と3番を適用してください」のように具体的に指示します。前述のとおり、大ざっぱな依頼では適用されないことがあるため、適用する項目を番号で指定するのが確実です。
手順5は、業務の出力で確かめることです。指示ファイルを直したら、代表的な商品データで商品説明文を作り、CSVを整形し、問い合わせを分類して、修正前の出力と比べます。文字数の上限、NGワード、出力形式が守られていれば完了です。モデルが更新されるたびに、この5手順を繰り返す運用にしておくと、指示ファイルの古さが溜まりません。
見直しに使えるプロンプト4本
/doctor prompt-auditはClaude Code専用の機能ですが、見直しの考え方はほかのAIでも応用できます。ここでは、ChatGPT・Claude・Geminiのいずれでも使えるプロンプトを4本紹介します。Claude Codeを使っていない会社が、社内のAI向け指示書を点検するときにも使えます。
プロンプト1は、指示書の中の古い書き方を洗い出すためのものです。/doctor prompt-auditと同じ観点を、汎用のAIに当てはめています。
プロンプト1:AI向け指示書の古い書き方の洗い出し
あなたはAIへの指示書の設計に詳しい担当者です。
以下はEC業務でAIに読ませている指示書です。次の4つの観点で問題のある箇所を洗い出してください。
指示書の書き換えはせず、指摘だけを出力してください。
観点:
1. 存在しないファイル名・フォルダ名・ツール名への参照({現在のフォルダ構成}と照合)
2. 指示どうしの矛盾(同じ項目について違うことを言っている箇所)
3. 過剰な強調(「絶対に」「必ず」「IMPORTANT」の連打など)
4. 理由が書かれていない禁止事項
指示書:{指示書の全文}
出力:観点番号、該当箇所の引用(1行)、問題の説明、修正の方向性
プロンプト2は、守るべき禁止事項に理由を添えて書き直すためのものです。強調を減らしても、ルールの重さが伝わる書き方に変えます。
プロンプト2:禁止事項に理由を添える書き換え
あなたはEC事業者のコンプライアンス担当です。
以下の禁止事項を、強調表現を使わずに、理由を1文添えた形に書き換えてください。
禁止の内容そのものは変えず、弱めないでください。
禁止事項:
{例:楽天R-Mailの本文に楽天市場外のURLを入れない}
{例:商品説明文に「最高」「No.1」「効く」などの表現を使わない}
{例:お客様の個人情報を出力に含めない}
出力形式:「〜しない。〜だからです。」の2文で1項目
プロンプト3は、指示書を直したあとに、業務の出力が変わっていないかを確かめるためのものです。手順5で使います。
プロンプト3:指示書の修正前後の出力比較
あなたはECの商品ページの品質を確認する担当者です。
同じ商品データから、修正前の指示書(A)と修正後の指示書(B)で作った商品説明文を比べてください。
確認する観点:
1. 文字数の上限({上限}文字)を守っているか
2. 禁止表現の一覧({一覧})に当たる表現がないか
3. 店舗の文体の指定({指定})を守っているか
4. 商品データにない事実を書いていないか
商品データ:{商品データ}
出力A:{修正前の出力}
出力B:{修正後の出力}
出力:観点ごとにA・Bの判定と、Bで悪化した点があればその内容
プロンプト4は、スキルの説明文を点検するためのものです。スキルは説明文をもとに呼び出されるため、説明が古いと、意図した場面で使われなかったり、別のスキルと取り違えられたりします。
プロンプト4:スキルの説明文の点検
あなたはAIエージェントの業務設計担当です。
以下はEC業務用のスキルの名前と説明文の一覧です。次の点を確認してください。
1. 説明文から、どんな依頼でこのスキルが使われるべきかが分かるか
2. 説明が重なっていて、どちらが使われるか曖昧なスキルの組み合わせはないか
3. 今は使っていない業務や画面の名前が残っていないか
スキル一覧:{スキル名と説明文の一覧}
出力:問題のあるスキル名、問題の内容、説明文の修正案(100字以内)
見直しでやってしまいがちな失敗と回避策
見直しの失敗は、「減らすこと」自体が目的になってしまうことから起きます。起きやすい3つのパターンを挙げます。
1つ目は、規約や法令に関わるルールまで削ってしまうパターンです。強調を減らす流れで、楽天市場の外部誘導の禁止や、薬機法上のNG表現の一覧まで「冗長」として消してしまうと、AIが規約違反の文章を作るリスクが一気に高まります。回避策は、手順3の分類で、規約・法令・個人情報に関わるルールを「残す」側に固定し、書き方だけを直すことです。
2つ目は、修正案をまとめて一気に適用するパターンです。指摘が数十件あると、すべて適用したくなりますが、どの修正が出力に影響したのかが分からなくなります。回避策は、ファイル単位、業務単位で適用し、そのたびに手順5の出力確認を挟むことです。
3つ目は、思考過程の書き出しを求める指示を残してしまうパターンです。クラスメソッドの記事では、指示ファイルがモデルに推論の過程を書き出すよう求めていると、Claude Opus 5.5などで安全上の理由から応答が止められる場合があると報告されています。「考えた手順をすべて書き出してから答える」のような古い指示は、この機会に削除するのが無難です。
運用のKPIと費用・工数の目安
見直しの効果を測る指標は、指示ファイルの総文字数、矛盾と存在しない参照の件数、業務の出力の合格率、やり直しの回数の4つです。総文字数は減らすこと自体が目的ではありませんが、矛盾と存在しない参照が0件になり、出力の合格率が維持されていれば、見直しは成功と判断できます。
費用面では、/doctor prompt-auditはClaude Codeの機能として使えるため、追加の契約は不要です。ただし点検ではモデルが指示ファイルを読み込んで推論するため、利用量に応じた消費が発生します。指示ファイルが大量にある場合は、範囲を絞って複数回に分けて実行すると、1回あたりの消費が読みやすくなります。
工数の目安は、指示ファイルが10本程度なら初回の見直しで半日、2回目以降はモデル更新のたびに1〜2時間です。品質の確認を数値で行いたい場合は、claude plugin evalでEC業務AIの品質を数値で担保する方法を組み合わせると、修正前後の差をより客観的に比べられます。
指示ファイルは「業務マニュアル」として育てる
/doctor prompt-auditの登場が示しているのは、AI向けの指示ファイルも、人向けの業務マニュアルと同じように定期的な棚卸しが必要になったということです。モデルは半年から1年で入れ替わり、そのたびに得意・不得意が変わります。指示ファイルを一度書いたら終わりの設定ではなく、育てていく社内の資産として扱う発想が求められます。
EC事業者にとって、この資産の中核は、店舗ごとの文体、モールごとの規約、商品ジャンルごとの法令上の注意点です。これらはモデルが変わっても変わらない知識であり、理由とセットで書いておけば、どのモデルにも伝わります。店舗ごとに文体を固定する方法は、Claude Codeのアウトプットスタイルで商品説明の文体を固定する手順で紹介しています。複数のAIで同じルールを共有したい場合は、AGENTS.mdの書き方もあわせて参考にしてください。
逆に、モデルの癖に合わせた細かい言い回しや、強調の重ね掛けは、モデルが変わるたびに古くなります。何を残し、何を手放すか。/doctor prompt-auditは、その線引きを定期的に見直すきっかけとして使うのが最も効果的です。
よくある質問
/doctor prompt-auditとは何ですか
/doctor prompt-auditとは、Claude Code 2.1.283で追加された、CLAUDE.mdやスキルなどの指示ファイルから古いモデル向けの書き方を洗い出す点検機能のことです。報告と修正案を出すだけで、ファイルを自動で書き換えることはありません。
実行するとファイルが書き換わってしまいませんか
いいえ、書き換わりません。修正案を確認したうえで、適用する項目を明示的に指示したときだけ反映されます。念のため、実行前にgitで状態を記録するか、フォルダを複製しておくと安心です。
楽天の規約や薬機法のルールまで消されませんか
この機能は、理由が書かれた禁止事項は残す方向で判断しますが、最終的な判断は人が行う必要があります。規約や法令に関わるルールは消さずに、強調を減らして理由を1文添える書き方に直すのが安全です。
APIキーなどの秘密情報は読まれませんか
検証記事によると、秘密情報を含む可能性がある設定ファイル(.claude/settings系のJSONや.mcp.json)は点検の対象外です。点検対象はCLAUDE.md、スキル、エージェント、コマンドなどの指示ファイルです。
Claude Codeを使っていなくても同じ見直しはできますか
はい、できます。本記事のプロンプト1から4は、ChatGPT・Claude・Geminiのいずれでも使えるように書いています。社内のAI向け指示書を貼り付けて、古い書き方の洗い出しと、禁止事項の書き直しを行ってください。
どのくらいの頻度で実行すればよいですか
主に使っているモデルが新しくなったときと、指示ファイルを大きく追記したときに実行するのが目安です。2026年はAnthropicだけでも主要モデルの更新が何度もあったため、少なくとも四半期に1回は見直すと、古い書き方が溜まりにくくなります。
/claude-api prompt-auditとは何が違いますか
/claude-api prompt-auditは、Claude APIで作ったアプリの中のプロンプトやリクエストのコードを点検する機能です。/doctor prompt-auditはClaude Code自身が読む指示ファイルを点検するもので、対象が異なります。
まとめ
Claude Codeの/doctor prompt-auditは、CLAUDE.mdやスキルに残った古いモデル向けの書き方を洗い出し、修正案を示す点検機能です。EC業務では、バックアップを取り、範囲を絞って点検し、指摘を4つに分類し、規約・法令のルールは理由を添えて残し、修正後は業務の出力で確かめる、という5つの手順で進めるのが安全です。まずはCLAUDE.mdを1つ指定して点検し、指摘の傾向をつかむところから始めてください。
参考文献
- クラスメソッド:Claude Code v2.1.282〜v2.1.283 の主要アップデート – /doctor prompt-audit の追加と auto mode の既定化
- Flavio Copes:How to audit your CLAUDE.md with /doctor prompt-audit
- Techstrong.ai:Anthropic cut 80% of Claude Code’s system prompt
著者:齋藤竹紘(株式会社オルセル 編集長/5,000社以上のEC支援実績/書籍3冊)
※うるチカラでは、生成AIの導入支援から運用最適化まで、貴社のEC事業に合わせたカスタマイズ提案を行っています。無料相談(30分)も実施中ですので、お気軽にお問い合わせください。
https://uruchikara.jp/contact/
【監修】齋藤竹紘(株式会社オルセル代表 / 19年・5,000社のEC支援実績)

株式会社オルセル代表取締役 / うるチカラ編集長。19年・5,000社以上のEC支援実績を持ち、楽天市場・Amazon・Yahoo!ショッピング・Shopify・Shopee越境ECの実装ノウハウを保有。AI×ECに関する書籍を3冊執筆。「現場で使えるAI実装」を一次情報として発信しています。