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 開始。

system-audit