| name | system-audit |
| description | 掃描 CLAUDE.md、MEMORY.md 與所有已安裝 skills，找出冗餘指令、臃腫內容、
重疊範圍與 token 浪費。產出清理建議並互動確認執行。
觸發詞：/system-audit、audit skills、audit claude.md、系統審核
|
| user_invocable | true |
| argument_hint | [focus: all | claude | memory | skills] (default: all) |
System Audit
掃描 Claude Code 設定生態系，找出可清理或最佳化的項目。一次涵蓋 CLAUDE.md、MEMORY.md、所有 skills。
Step 0: 掃描所有來源
讀取 CLAUDE.md
按順序讀取（每個都算 token）：
- 全域
~/.claude/CLAUDE.md
- 專案
CLAUDE.md（當前目錄）
- 專案私有
.claude/CLAUDE.md（如存在）
讀取 MEMORY.md
- Auto Memory — 專案級
.claude/projects/*/memory/MEMORY.md
- 該目錄下的所有
.md 附屬檔案
掃描 Skills
- 全域 skills —
~/.claude/skills/*/SKILL.md（含 references/ 子目錄）
- 專案 skills — 當前目錄下任何含
SKILL.md 的子目錄
對每個 skill 記錄：
- SKILL.md 行數
- references/ 檔案數與總行數
- 預估 token 數（行數 × 4 粗估）
ARGUMENTS 過濾
如果 ARGUMENTS 指定了 focus（claude / memory / skills），只執行對應段落。預設 all。
Step 1: CLAUDE.md 審查
逐檔分析，找出以下問題：
1A. 冗餘指令
- 跨檔重複的指令（全域 vs 專案級說了同一件事）
- 同檔內重複表達同一規則
1B. 臃腫內容
- 超過 3 行的範例或解釋 → 可否壓縮？
- 歷史脈絡描述（「之前我們試過 X 但失敗」）→ 搬到 memory
- 低頻使用的指令 → 改做 skill 或 slash command
1C. 過時內容
- 提到已不存在的檔案、功能、或工具
- 版本號/日期看起來過時
- 與現有 codebase 矛盾的描述
1D. Token 估算
| 檔案 | 行數 | 預估 tokens | 問題數 |
|------|------|------------|--------|
| ~/.claude/CLAUDE.md | 200 | ~3,200 | 3 |
| CLAUDE.md | 50 | ~800 | 1 |
Step 2: MEMORY.md 審查
2A. 過時條目
- 描述已完成/已不存在的功能
- 與現有程式碼矛盾的技術發現
- 被後續條目取代的舊記錄
2B. 與 CLAUDE.md 重複
- memory 和 CLAUDE.md 說同一件事 → 保留一處，刪另一處
- 判斷標準：高頻查用留 CLAUDE.md，低頻留 memory
2C. 組織問題
- 過長條目 → 拆到獨立
.md 檔
- 分類不清楚的條目 → 建議歸類
- 接近 200 行上限 → 標記需要瘦身
Step 3: Skills 審查
3A. 總覽表
| Skill | SKILL.md 行 | Refs 行 | 預估 tokens | 觸發詞 |
|-------|-------------|---------|------------|--------|
| good-writing-zh | 165 | 158 | ~1,300 | /good-writing |
| humanizer-tw | 122 | 450 | ~2,300 | humanize |
| ... | | | | |
3B. 範圍重疊
掃描所有 skill 的 description + 觸發詞，找出：
- 功能重疊的 skill 對（如 good-writing-zh ↔ humanizer-tw 的邊界是否清楚？）
- 觸發詞衝突（不同 skill 回應同一關鍵字）
3C. Token 效率
- SKILL.md 超過 200 行 → 建議瘦身（抽到 references/）
- references/ 超過 500 行 → 是否有低頻內容可刪？
- 有沒有 skill 其實很少用，但每次載入成本很高？
3D. 結構問題
- 缺少 frontmatter（name / description / user_invocable）
- 缺少 argument_hint
- references/ 內有未被 SKILL.md 引用的孤立檔案
Step 4: 呈現結果 + 互動執行
產出審查報告
## System Audit 報告
### Token 預算概覽
| 類別 | 每次對話載入 | 按需載入 |
|------|------------|---------|
| CLAUDE.md（全域+專案） | ~4,000 | — |
| MEMORY.md | ~3,200 | — |
| Skills（平均每次觸發） | — | ~2,000 |
### 發現問題
| # | 類別 | 嚴重度 | 描述 | 建議動作 |
|---|------|--------|------|---------|
| 1 | CLAUDE.md | 高 | 重複指令 X 出現在全域和專案級 | 刪除專案級 |
| 2 | MEMORY.md | 中 | 條目 Y 已過時 | 刪除 |
| 3 | Skills | 低 | skill Z 的 refs 有孤立檔案 | 清理 |
AskUserQuestion 互動
用 multiSelect 讓使用者勾選要執行哪些清理動作：
- 每個發現列為一個選項
- 標註嚴重度和預估影響（省多少 token / 行）
- 使用者確認後才動手
執行清理
使用者勾選的項目，逐一執行（Edit / Write）。每個動作完成後簡短回報。
審查原則
- 每次對話載入的內容越少越好 — CLAUDE.md 和 MEMORY.md 是最貴的，因為每次都載入
- 低頻內容移到 skill 或 memory — 不是每次都用的指令不該佔 CLAUDE.md
- Skills 之間邊界要清楚 — 重疊的 skill 浪費 token 也讓 Claude 困惑
- 過時資訊要刪 — 錯誤的記憶比沒有記憶更危險
Now Execute
使用者的審查請求見下方 ARGUMENTS:。從 Step 0 開始。
