Skip to content

/maigo:repo-audit

🌙 Doloris：讓我們看清楚，這個 repo 裡還留著什麼。

read-only 內部健診——不刪 branch、不關 PR、不改 code。 只掃描、彙整，把可執行的處置選項交回給你。

使用

/maigo:repo-audit

無參數。對當前所在的 git repo 執行。

四個資料源（全 read-only）

A. 已合併可刪的 branch

git branch --merged main

過濾掉 main 與當前 branch 自身，列出其餘已合入 main 的本地 branch。 → 列出，不刪除。

限制：假設 main-based 工作流（main 為基準 branch）。detached HEAD 或其他分支策略的邊界情況暫不處理。

B. 未關 PR（需要 gh CLI）

gh pr list --state open

列出 open 狀態的 PR。 → 列出，不關閉。

若 gh 未安裝或未登入：跳過本段，🌑 Mortis 一句告知，A / C / D 照跑，整輪不中斷。

C. 程式碼積壓（TODO / FIXME）

grep -rn -E "TODO|FIXME" agents/ commands/ skills/ scripts/ docs/ hooks/

限定 repo 自有目錄，排除 .venv/、node_modules/ 等第三方目錄，避免第三方套件 TODO 噪音。 → 列出，不修改。

D. Skill 健診

orchestrator 讀 skills/*/SKILL.md（不開新 agent），三類檢查：

  1. 孤兒 skill：對每個 skills/<name>/，grep commands/、agents/、skills/（排除自身）、 hooks/ 找 inbound 引用；零引用 → 孤兒候選。但部分 skill 純靠 frontmatter description 被 model 觸發（repo-detect 型，如 airflow-aware、commitizen-aware），不靠文字引用—— 這類即使零 grep 命中也標註「model-triggered，非引用型」，不當真孤兒。
  2. 重疊候選：讀所有 SKILL.md 的 description + Consumers，用判斷力標出兩個 description 幾乎互相涵蓋、consumer 集合高度重疊的配對 → 列為「考慮合併」候選，附一句理由。 注意：co-load（同一命令常同時載入兩個 skill）不等於重疊——先確認兩者是刻意分工 （如各自負責不同關注點）還是內容真的重複，分工型不列為候選。
  3. 指向失效：grep 各 SKILL.md 內文的 inline code 路徑（skills/...、scripts/...、 ${CLAUDE_PLUGIN_ROOT}/...），確認目標存在——markdown link 已由 validate_plugin.py 的 check_relative_links 擋，這裡只補它不查的 inline code 指向類。

→ 三類都只列出，不合併、不刪除、不改指向——advisory，判斷與執行留給使用者或後續 /maigo:crystallize。

輸出結構

各段有發現時，彙整成單一 fenced code block 的處置 checklist：

# repo-audit 處置 checklist（以下指令 repo-audit 不會執行，確認後自行貼）

## A. 可刪 branch
git branch -d <branch-name>
# 若需要刪遠端：git push origin --delete <branch-name>

## B. 待處理 PR
gh pr view <number>
# gh pr close <number>  # 若確認要關

## C. TODO / FIXME
# <file>:<line>: <內容>
# → 自行決定修復或移除

## D. Skill 健診
# 孤兒（非 model-triggered）：<skill> — 零 inbound 引用
# 重疊候選：<skill A> / <skill B> — <一句理由>
# 指向失效：<skill>/SKILL.md → `<path>` 不存在
# → 合併 / 退役 / 修指向，交你或 /maigo:crystallize 判斷

各段無發現則省略該段；四段全空則省略整個 checklist。 範例 code block 內不寫絕對路徑——以相對路徑或 ~/ 表示。

結算

🌑 Mortis：<結算句>
  • 全乾淨：「這次是乾淨的。就這樣。」
  • 有積壓：靜靜指出剩幾件，不催促（1 句、克制）。

Orchestrator 守則

  • 完全 read-only：不刪 branch、不關 PR、不改 code；處置只輸出文字，不執行。
  • 不 delegate 五人：orchestrator 直接執行 git / gh / grep 指令 + 讀 SKILL.md 判斷，彙整輸出。
  • 任一指令失敗 → 跳過該段 + Mortis 1 句告知，不中斷整輪：
  • gh 失敗（未安裝 / 未登入）→ 跳過 B 段
  • git / grep 失敗 → 跳過對應段
  • D 段是判斷型 advisory：孤兒 / 重疊 / 指向失效三類都只列出候選，不代使用者拍板合併或刪除。
  • 開場：🌙 Doloris 帶入（鋪陳語氣，見 skills/narration）。
  • 收場：🌑 Mortis 1 句結算。

與其他命令的差異

命令 對象 場景
/maigo:doctor 環境依賴（gh, git, python） 「東西跑不起來，先診斷」
/maigo:triage-issue inbound GitHub issue 「inbox 積了一堆 issue，批次 triage」
/maigo:repo-audit repo 自身（branch / PR / TODO） 「定期清 repo，看積壓了什麼」

→ 場景對照、其他命令：Commands reference