claude-code/claude-zh/skills/skill-stocktake/SKILL.md

name	description
skill-stocktake	用於稽核 Claude 技能與指令品質的功能。支援「快速掃描」(僅針對有變動的技能) 與「全面盤點」(Full Stocktake) 模式，採用子 Agent 循序進行批次評估。

技能盤點技能 (Skill Stocktake Skill)

斜線指令 (/skill-stocktake) 用於掃描並稽核所有 Claude 技能與指令。透過品質檢查清單與 AI 綜合判斷，提供修復、更新或汰換建議。支援兩種模式：針對近期變動進行的「快速掃描」，以及全量審視的「全面盤點」。

掃描範圍

此指令針對調用目錄的相對路徑進行掃描：

路徑位置	說明
~/.claude/skills/	全域技能 (適用於所有專案)
{cwd}/.claude/skills/	專案級技能 (若目錄存在則包含)

在執行第一階段 (Phase 1) 時，指令會明確列出偵測到的路徑及其掃描狀態。

針對特定專案進行盤點

若要包含專案級技能，請在該專案的根目錄下執行：

cd ~/path/to/my-project
/skill-stocktake

執行模式

模式名稱	觸發條件	預期耗時
快速掃描 (Quick Scan)	存在 results.json 快取	5–10 分鐘
全面盤點 (Full Stocktake)	缺失 results.json 或強行執行 /skill-stocktake full	20–30 分鐘

執行流程

第一階段 — 資源盤點 (Inventory)

調用腳本列舉所有技能檔案、擷取 Frontmatter 資訊並收集檔案最後修改時間 (mtime)。

第二階段 — 品質評估 (Quality Evaluation)

啟動 Task 子 Agent 針對盤點清單進行深度審查。評估維度包含：

• 可執行性：是否具備可立即操作的程式碼範例或指令。
• 範圍適切性：名稱、觸發條件與內容是否對齊；不應過於寬泛或過於瑣碎。
• 唯一性：內容是否無法被 MEMORY.md 或其他現有技能取代。
• 時效性：所引用的技術版本、API 或參數在當前環境下是否依然有效。

判定標準 (Verdicts)

判定結果	具體定義
保留 (Keep)	功能實用且符合當前技術現狀。
優化 (Improve)	值得保留，但需要具體的內容改進。
更新 (Update)	引用技術已過時（需透過網頁搜尋驗證新版本）。
汰換 (Retire)	品質低劣、內容陳舊或維護成本過高。
合併至 [X]	與其他技能有重大重疊，標註合併目標。

第三階段 — 摘要表產出 (Summary)

整理所有技能的盤點結果，包含判定理由與建議動作。

第四階段 — 執行鞏固 (Consolidation)

1. 汰換/合併：在用戶確認前，提示詳細的判定理由與替代方案。
2. 優化建議：提供具體的修改方案（如：刪除重複段落、精簡篇幅）。
3. 知識壓縮：檢查 MEMORY.md 長度，若過長則建議進行壓縮。

結果記錄檔案語法

快取路徑：~/.claude/skills/skill-stocktake/results.json

此檔案完整記錄每次盤點的時間、模式、進度以及各項技能的判定明細，確保盤點工作可續傳且具備可追溯性。

重要準則

• 盲測原則：所有技能不論來源為何，皆適用同一套檢查清單進行評估。
• 顯式確認：任何涉及刪除或封存檔案的操作，均必須獲得用戶的明確授權。
• 理由充分性：判定理由必須具備決策參考價值，嚴禁僅填寫「無變動」等單薄字眼。