Agent Doctor
使用此技能來針對實際存在的檔案，診斷代理指令與技能探索的相關問題。它會將來源報告為已發現，而非執行時期已載入或設定為可用。
請先執行確定性掃描，然後僅根據報告及其指名的檔案進行推理。該掃描為唯讀操作，不會修復檔案、載入技能、請求權限，也不會讀取一般家目錄、環境、憑證或驗證檔案。
從此技能的安裝目錄執行：
python3 scripts/agent_doctor.py --project <path-to-project> --format markdown
使用 --home /fixture/home 來指定測試用或替代的全域發現路徑。僅在需要額外允許的技能根目錄時，才加入明確的 --skill-root /path/to/skills 參數。--model <name> 接受您正在執行的模型名稱（任何文字名稱，例如 Claude、claude-opus-5-5 或 GPT-5），並將其與一般技能文字中「You are 」這類文字身分宣告進行比對，忽略大小寫、連字號與空格或句點的差異，以及開頭的 claude-，並將不符之處僅回報為建議事項。若省略此參數則跳過該檢查。選擇 --format json 可取得機器可讀的輸出。使用 --max-files、--max-bytes 及 --max-directories 來縮小掃描範圍，進行針對性診斷。
掃描會限制深度、目錄數、檔案數與位元組數；它會跳過依賴、版本控制、快取及工作樹目錄。它會辨識上層與巢狀的 AGENTS.md/CLAUDE.md/GEMINI.md、允許的全域指令檔案（~/.codex/AGENTS.md、~/.claude/CLAUDE.md、~/.gemini/GEMINI.md），以及每個已記錄主機資料夾中的平面技能資料夾：家目錄下的 .agents、.codex、.claude、.gemini、.cursor、.copilot 與 .codeium/windsurf 技能，以及專案中的 .agents、.codex、.claude、.gemini、.cursor、.github、.opencode、.cline、.clinerules、.devin 與 .windsurf 技能。若某個技能可透過多個資料夾觸及（例如 Skills CLI 的符號連結），僅回報一次。它會保持正規路徑與別名分離，拒絕符號連結逸脫，且不輸出原始檔案內容。
技能使用與歸檔
對於很少或從未被呼叫的技能，請執行 python3 scripts/agent_doctor.py --usage 並參閱 references/usage.md。它會以唯讀方式讀取工作階段記錄，僅輸出技能名稱與呼叫次數。向擁有者顯示該表格，然後針對每個技能詢問：更新、保留或歸檔。請說「在記錄中未找到任何呼叫」，而不是「未使用」。僅使用 scripts/skill_archive.py 進行歸檔：先 plan，顯示計畫，取得對該技能的明確同意，然後 archive --yes；切勿在詢問的同一回合中執行歸檔。請提及 restore。