system-audit

掃描 CLAUDE.md、MEMORY.md 與所有已安裝 skills,找出冗餘指令、臃腫內容、 重疊範圍與 token 浪費。產出清理建議並互動確認執行。 觸發詞:/system-audit、audit skills、audit claude.md、系統審核

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "system-audit" with this command: npx skills add yelban/orz99-skills/yelban-orz99-skills-system-audit

System Audit

掃描 Claude Code 設定生態系,找出可清理或最佳化的項目。一次涵蓋 CLAUDE.md、MEMORY.md、所有 skills。


Step 0: 掃描所有來源

讀取 CLAUDE.md

按順序讀取(每個都算 token):

  1. 全域 ~/.claude/CLAUDE.md
  2. 專案 CLAUDE.md(當前目錄)
  3. 專案私有 .claude/CLAUDE.md(如存在)

讀取 MEMORY.md

  1. Auto Memory — 專案級 .claude/projects/*/memory/MEMORY.md
  2. 該目錄下的所有 .md 附屬檔案

掃描 Skills

  1. 全域 skills~/.claude/skills/*/SKILL.md(含 references/ 子目錄)
  2. 專案 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 開始。

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

good-writing-zh

No summary provided by upstream source.

Repository SourceNeeds Review
General

humanizer-tw

No summary provided by upstream source.

Repository SourceNeeds Review
Coding

codex-plan

No summary provided by upstream source.

Repository SourceNeeds Review
General

project-profiler

No summary provided by upstream source.

Repository SourceNeeds Review