memory-lint

# memory-lint — Memory 品質健檢 ``` Phase 1 唯讀掃描 ──► 報告（預設只做這段，不動任何檔案） │ user 逐條拍板要修哪些 Phase 2 執行修正 ──► commit（開工前先記回退點） │ 改完全部提交 = 凍結 Phase 3 獨立複驗 ──► 過 → 收工　／　不過 → 回退到 Phase 2 前 ``` 🔴 **收到 lint 觸發詞的預設動作是出報告。** user 必須明確點名要修哪幾條 （或明說「全部修掉」）才准進 Phase 2。Phase 1 期間不准順手合併、順手刪、順手歸檔。 **跟 llm-wiki-lint 差異**：本 skill 針對 memory 目錄（prefix-based 平鋪結構）； `llm-wiki-lint` 針對 Karpathy LLM Wiki repo（`wiki/` + `raw/` + `SCHEMA.md` 三層）。 --- # Phase 1 — 唯讀掃描 ## Step 1: 找到 memory 目錄 依序嘗試，命中第一個就用： | 順序 | 來源 | |------|------| | 1 | `$ARGUMENTS` 第一個位置參數 | | 2 | 環境變數 `$CLAUDE_MEMORY_DIR` | | 3 | `settings.json` 的 `autoMemoryDirectory` | | 4 | `~/.claude/memory/` | | 5 | 都找不到 → **停止**，告訴 user「偵測不到 memory 目錄」，不要瞎猜 | 第 3 條要看**當前設定目錄**（多帳號並存時 `$CLAUDE_CONFIG_DIR` 會指到別處）： ```bash CFG="${CLAUDE_CONFIG_DIR:-$HOME/.claude}" MEMORY_PATH=$(jq -r '.autoMemoryDirectory // empty' "$CFG/settings.json" | envsubst) ``` ## Step 2: 跑機械掃描 ```bash # <skill_dir> = 本 SKILL.md 所在的目錄；掃描標的由參數帶入， # 所以在哪個工作目錄呼叫都不影響結果 python3 <skill_dir>/scripts/scan.py "$MEMORY_PATH" ``` 只用標準函式庫、唯讀、輸出 JSON。**目標目錄由參數帶入**，所以在哪個工作目錄呼叫都一樣。 沒有 `MEMORY.md` 會回 `{"fatal": ...}` 並以 exit 1 結束。 腳本已經處理掉幾個會讓檢查靜默失效的坑，**不要自己在對話裡改寫成 shell 一行流**： - 不用 shell glob（zsh 未匹配 glob 會在指令執行前中止，而且 `2>/dev/null` 擋不住） - 不用固定路徑暫存檔（並行執行會互相覆蓋、失敗留髒資料） - 不 import 第三方套件（唯讀階段不該動 user 的 Python 環境；離線環境也裝不了） - `[[...]]` 掃描先剝掉 fenced 與行內 code，且**檔名與 frontmatter `name` 兩種都算解析成功** - 索引目標的 `./` 前綴會正規化 輸出欄位： | 欄位 | 意義 | |...