小編精選 - 技術文章翻譯 · 09月28日

Claude Code 的新稽核指令，預設情況下不會看到我的 49 個技能

Claude Code 2.1.283（2026-09-25）的 changelog 裡這樣寫著：

Added /doctor prompt-audit (also /checkup prompt-audit) to audit your CLAUDE.md files,
skills, agents and commands for prompting patterns written for older models

可以理解成它會指出我的 CLAUDE.md 和技能是不是用了舊式寫法。
因為我有 49 個技能、286 個子代理，所以立刻拿來試了。

第一次　在專案內執行　21.7 分鐘 / $10.69 / 66 筆
      → ~/.claude 沒有取得權限，技能和子代理也都不在範圍內

第二次　傳入 --add-dir　12.7 分鐘 / $9.62 / 12 筆
      → 辨識出 45 個技能、286 個子代理

合計約 34 分鐘、$20.31。出現的並不是「舊模型用的寫法」

驗證環境：Windows 10 / 隔離安裝 Claude Code 2.1.283 / claude -p / 測量日期 2026-09-28

第一次：一個技能都沒看到

我在實際專案（CLAUDE.md 167 行）中執行了 /doctor prompt-audit。

大約花了 22 分鐘，回來 66 條指摘。 下面是指摘表格中的一行
（擷取了對應位置與根據欄位）。

docs/git-branch-strategy.md に従い、feater/LABEL-XXX_作業内容
／參照先は 2025-09-09（4da04ff）に削除、この行は 2026-06-22 記述

問題出在範圍。 報告開頭這樣寫著：

未監査のもの。 Next, the permission prompt couldn't be approved in a non-interactive session, so even the listings couldn't be read:
~/.claude/CLAUDE.md、~/.claude/{rules,skills,commands,agents,output-styles}、~/.claude/plugins

記錄裡有 22 個錯誤。其中 15 個是權限被拒，5 個是嘗試讀取 ~/.claude 時被擋下來。

Claude requested permissions to read from C:\Users\...\.claude,
but you haven't granted it yet.

49 個技能和 286 個子代理，一個都沒看。
實際上只審查了專案內的 18 個檔案。

如果用 -p 或在 CI 裡跑，這裡會默默漏掉一半。

第二次：加上 `--add-dir` 就會去看

加上 --add-dir ~/.claude，在幾乎空白的專案裡重新跑了一次。

1 次（只含專案）2 次（含 --add-dir）所需時間（API 時間）21.7 分鐘12.7 分鐘成本$10.69$9.62 輸出 token105,58953,868 工具呼叫75 次56 次審查的對象專案 18 個檔案45 個技能 / 286 個子代理指摘 66 筆12 筆**這次有看到了。不過讀法還是掃過而已**。針對 ~/.claude 的 49 次操作內訳如下。

工具次數做了什麼Grep19 次批次掃描Glob16 次取得清單Bash6 次一起 grepRead**8個別開啟完整讀過的，只有 286 個子代理中的 2 個，以及 3 個技能檔案**（systematic-debugging 與
review-python-backend 這 2 個技能）。另外還有 2 個只讀了一部分。
報告本身也這樣說：

沒有逐一完整閱讀 45 個技能（中訊號區間以 grep 為主）

出現的不是「舊模型用的寫法」

changelog 寫的是「prompting patterns written for older models」。
從各分類的件數來看，那部分其實很少。

分類1 次目2 次目舊模型用的語句142**設定陳舊／矛盾498**工具說明00結構322 次目的報告裡明確寫著：

壓力語密度很低，budget_tokens、prefill、以及「think step by step」等 API 化石是零

反而出現的是環境裡的化石。

有 5 處是別的使用者的 macOS 絕對路徑（/Users/takahiromiyamoto/.claude/skills/...）
*有 4 個技能在引用不存在的外掛名稱 `document-skills:`**
*有技能在引用未安裝的 `superpowers:`**

第一個問題是我自己也知道的缺陷，這次是獨立找出來的。

在第一次結果裡，還有更有感的指摘：

6 個專案用代理中，有 5 個在本次工作階段無法使用。
清單上只有 playwright-tester，而 code-reviewer 則被解析到使用者側的另一個代理
（TDD Gate 3 用）

說不出來的事

只測了 2026-09-28 這一天，而且每種情境各 1 次。 結果可能每次都不一樣
我只數了指摘件數與分類。 沒有逐條驗證每個指摘是否正確
評分標準沒有公開。 也不清楚它是依據什麼判定為「舊」
我的環境有 49 個技能、286 個子代理。前提比一般素環境更多
技能數量對不起來。 目錄是 49 個，SKILL.md 有 48 個，報告顯示 45 個。3 個差異的原因我沒有確認
尚未在對話式工作階段驗證。 還沒確認在對話中核准權限時會怎樣
成本是 --output-format 回傳的 total_cost_usd。實際請款會依方案不同而有差異

總結

/doctor prompt-audit 預設不會看使用者層級。 在 -p 下權限不會下來，
49 個技能與 286 個子代理都不在範圍內
傳入 --add-dir ~/.claude 就會去看。 但實際完整打開的只有2 個子代理、2 個技能
很貴。 1 次 $10.69 和 $9.62，加起來 $20.31 / 約 34 分鐘
幾乎不會出現「舊模型用的寫法」。 API 化石是零，
出現的是已刪除檔案、別台機器的絕對路徑、以及不存在的外掛名稱
指摘品質很高。 甚至能對上 git 歷史，寫出「什麼時候被刪掉」都查得到