/claude-api prompt-audit とは?使い方と、直す前に確かめること

/claude-api prompt-audit とは?使い方と、直す前に確かめること、の題を白い板に載せたアイキャッチ。左下に虫めがねと書類、右下にチェックの付いた書類

モデル(頼んだことを考えて答える
Claude の種類)が新しくなったけれど、
前に書いた決まりのメモやスキルは、
このままで合っていますか?

デスクトップアプリ(パソコンに入れる Claude のアプリ)で Claude Code を使っていると、決まりのメモ(CLAUDE.md。Claude Code が毎回最初に読むファイル)やスキルに、前のモデルに合わせて書いた指示や、ファイル同士で食い違う指示が残ることがあります。

「/claude-api prompt-audit」と打つと、
古いモデル向けの指示を点検して、
直し方の案を出してくれます

決まりのメモのページには、指示を点検する入口として /doctor prompt-audit が書かれていて、中では /claude-api のスキルを通って動きます。公式は、その /doctor prompt-audit の説明で、「Claude に適用するよう依頼するまでファイル内の何も変更されません」と書いています(公式のページ)。

私もデスクトップアプリで決まりのメモを点検してもらい、仕組みを壊さないかを Claude に聞いてから、直してもらいました。

打ち方と、直す前に確かめることを、下で順に書きます。

この記事で分かること
  • prompt-audit が何を見て、何を出すか
  • デスクトップアプリでの打ち方と、
    /doctor prompt-audit との違い
  • 出た案で直す前に確かめること
    (私の記録)
  • 出てこない・使えないときにすること
目次

prompt-audit は
何をしてくれる?

prompt-audit が何をしてくれるかを、公式の書き方ごとに2段に分けた図。上の段は /claude-api prompt-audit の公式の表で、プロンプト・スキル・道具の説明を見て、古いモデル向けの指示に印をつけ、直し方の案を出す。下の段は /doctor prompt-audit の公式の説明で、決まりのメモ・スキル・ルールなどを見て、古いモデル向けの指示と、無い物への参照と、食い違うファイルを見つけ、直し方の案を出す。頼むまで何も変わらない

古いモデル向けの指示に印をつけて、
直し方の案を出すスキルです

/claude-api prompt-audit が見る指示
  • プロンプト(Claude への指示の文)
  • スキル
  • 道具の説明(Claude が使う道具の
    説明の文)

公式の表では、この中の古いモデル向けの指示に印をつけ、直し方を案として出すと書かれています(公式のページ)。

スキルの1つで、
作り直す物ではない

/claude-api は、Claude Code に入っているスキルの1つです。

スキルは、Claude に詳しい手順を渡して動かす物で、「/」に名前を続けて呼びます(公式のページ)。

prompt-audit は、指示を点検して直し方の案を出す物で、決まりのメモを一から作り直す物ではありません。

/doctor prompt-audit の
公式の説明では

入口は2つあります。私が使ったのは /claude-api prompt-audit で、下の「打ち方」もこちらです。もう1つの /doctor prompt-audit は、公式が決まりのメモの点検として説明している名前で、中では同じスキルを通ります(公式のページ)。

この記事の「公式の表」と「公式の説明」
  • 公式の表:スキルのページの
    一覧。
    /claude-api prompt-audit のこと
  • 公式の説明:決まりのメモの
    ページの説明。
    /doctor prompt-audit のこと
公式の説明で探す物
  • 古いモデル向けの指示
  • 無いファイルやコマンドへの参照
  • 互いに食い違うファイル

見る物は、決まりのメモやスキルなどです。

1つのファイルやフォルダだけを見てもらうこともできます。

/doctor prompt-audit の
公式の説明では、
Claude に直すよう頼むまで、
ファイルの中は何も変わりません
。

食い違うと、Claude がどちらか一方を選んで動くことがあります(公式のページ)。

決まりのメモに何を書くかは、CLAUDE.md の記事に書いています。

デスクトップアプリでは、
どう打つ?

Code のタブの入力欄に、
/claude-api prompt-audit と
打って送ります

Code のタブは、デスクトップアプリで Claude Code を使う画面です。

打ち方

STEP
点検したいフォルダで開く

決まりのメモがあるフォルダで、
Code のタブの会話を始めます。

STEP
入力欄に「/」と打つ

「/」と打つか、「+」から Slash commands を選ぶと、
使える物が一覧で出ます。

STEP
続けて打って送る

「/claude-api prompt-audit」と
最後まで打って、送ります。

「/」の一覧の出し方は、公式のデスクトップのページにあります。

私が使ったのは、この /claude-api prompt-audit です。

/doctor prompt-audit
との違い

公式は、決まりのメモの点検の入口として /doctor prompt-audit も挙げていて、これも中では /claude-api のスキルを通って動きます。

2つの入口で、公式に書いてあること
  • /claude-api prompt-audit は、
    プロンプトやスキルなどの
    古い指示を見て、
    直し方を案として出すと、
    公式の表にあります。
  • /doctor prompt-audit は、
    無い物への参照や食い違いも探し、
    頼むまで何も変えないと、
    公式の説明にあります。
  • /doctor とだけ打つと、指示ではなく、
    セットアップの点検になります。

点検の結果は、全部直していい?
直す前に確かめること

出るのは直し方の案です。
直す前に、
何が変わるかを Claude に聞いてから
頼みます

直す前に、何が変わるかを聞く流れの図。公式の説明の並びで見つかる指摘の種類は、古いモデル向けの指示、無いファイルやコマンドへの参照、互いに食い違うファイル。点検で出るのは直し方の案で、何が変わるかを Claude に聞いて、納得してから直してもらう。良くなったかは、直した後に使って確かめる

公式の説明では、結果は、直し方の案を含む報告で出ます(公式のページ)。

見つかる指摘の種類は、上の図の左のとおりです。

私の場合

決まりのメモを最初に作ってもらったあと、「/」から呼ぶ点検も使いました。そのことを、私はこう話していました(「そこでも」は、最初に作ってもらったときに加えて、という意味です)。

そのあとに/で最新モデルに最適にするやつあったよね?そこでも最適化してもらった

私は「最適化」と呼んでいましたが、
prompt-audit は、作り直す物ではなく、
点検して直し方の案を出す物です。

私も最初は、作り直してくれる物だと思っていて、結果を見て「これってclaudeの公式のやつで、最新モデルに最適化してくれるんだよね?」と聞いていました。

点検の結果は直し方の案だけで、ファイルは書き換わっていませんでした。

直す前に、私は Claude にこう聞きました。

これらの直すべきところはある意味仕組みは壊さずにより良いものにしてくれる感じかな?

Claude は、直しの種類を分けて答えてくれました。

それを見てから「それで全てOKです」と答え、直してもらいました。

直す前に確かめること

案で直す前に確かめること
  • その直しで、
    Claude の動きが何か変わるか
  • 直す所が、
    今の自分の使い方と合っているか

1つ目は私が直す前に聞いたこと、2つ目は私からのすすめです。

良くなったかは、直した後に確かめます
点検は直し方の案を出す物です。
良くなったかは、そのあと
使って確かめる段階が残ります。

prompt-audit が出てこない・
使えないときは?

Code のタブの Claude Code の
版を見て、古ければ新しくします

版は、Claude Code の新しさを表す番号です。

使える版(公式)
  • /claude-api prompt-audit は、
    v2.1.221 以降で使えます。
  • /doctor prompt-audit は、
    v2.1.283 以降が要ります。

版を見る

STEP
/status と打って送る

Code のタブの、自分のパソコンで動かす会話で、
入力欄に /status と打ちます。

STEP
Claude Code の行を見る

Claude Code の行に、
いま使っている版が出ます。

新しくする

STEP
更新を確かめて入れる

Mac は「Claude > Check for Updates…」、
Windows は「Help > Check for Updates…」から入れます。

STEP
新しい会話を始める

入れた後は、新しいセッション(会話)を始めます。

版の見方と新しくし方は、公式のデスクトップのページにあります。

/claude-api のスキルを切っていると、/doctor prompt-audit も使えません(公式のページ)。

最初から入っているスキルは、設定でまとめてでも1つずつでも切れると公式にあります(公式のページ)。自分で設定を変えた覚えがなければ、まず上の版を確かめてください。切っているか分からないときは、Code のタブで Claude に、/claude-api のスキルを切る設定になっていないかを見てほしいと頼んでみてください。

よくある質問

prompt-audit を打つと、
ファイルが勝手に書き換わりますか?

/doctor prompt-audit の公式の説明では、Claude に直すよう頼むまで、ファイルの中は何も変わりません。

/claude-api prompt-audit の公式の表には、直し方を案として出すと書かれています。

API を使ったアプリを
作っていなくても使えますか?

/doctor prompt-audit の公式の説明は、決まりのメモやスキルなどを見ると書いていて、API(プログラムから Claude を呼び出す仕組み)を使ったアプリに限っていません。

/claude-api prompt-audit は、公式の表が「Claude API プロジェクトで作業する」の節にあり、API を使わないフォルダで使えるかは書かれていません。私は決まりのメモの点検で打って、案が出ました。

決まりのメモ(CLAUDE.md)の点検は、公式の説明が /doctor prompt-audit で書いている範囲です。出てこないときは、上の「出てこない・使えないときは?」を見てください。

どのくらいの間隔で打てばいいですか?

公式は、決まりのメモを定期的に見直すようすすめています。

新しいモデルに変わったときや、決まりのメモを大きく直したときに、打ってみるのがおすすめです。

/doctor とだけ打つと、
何が起きますか?

公式には、指示ではなく、セットアップの点検になると書かれています。

指示を点検するときは、/doctor prompt-audit と続けて打つと、公式にあります。この記事の打ち方は /claude-api prompt-audit です(公式のページ)。

まとめ:点検の案で直す前に

この記事の結論
  • /claude-api prompt-audit と打つと、
    古いモデル向けの指示を点検して、
    直し方の案を出します。
  • 公式の説明では、
    /doctor prompt-audit は、
    頼むまでファイルを何も変えません。
  • 直す前に、
    その直しで Claude の動きが
    何か変わるかを聞きます。

やってみること
決まりのメモがあるフォルダで、
Code のタブに
/claude-api prompt-audit と打ち、
出た案で直す前に、
何が変わるかを Claude に
聞いてみてください。

次は、作業ごとにどのモデルを使うかを決めてみてください。

参考になったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
目次