triage（故障分诊）

/triage — Skills Portfolio 分流管理

基於 skills-ecosystem-eval 的消融實驗結果，管理 learned skills 的生命週期。

Step 0: 檢查工具

確認 ~/.claude/scripts/skills-triage.sh 存在且可執行：

ls -la ~/.claude/scripts/skills-triage.sh

若不存在，提示使用者安裝：

skills-triage.sh 未找到。請先從 agent-skills repo 複製： ``bash cp ~/Documents/agent-skills/triage/skills-triage.sh ~/.claude/scripts/ chmod +x ~/.claude/scripts/skills-triage.sh ``

Step 1: 查看狀態

~/.claude/scripts/skills-triage.sh status

顯示已退役數量、清單、及審計日誌。

如果 /skill-health command 可用，建議先執行以取得 portfolio 全局視圖（重複覆蓋率、gap 分析），再決定退役優先順序。

Step 2: 退役 Skill

使用者提供 skill 名稱和原因時：

~/.claude/scripts/skills-triage.sh retire <name> "<reason>" <tier> <delta>

• tier：T1（degraded）、T2（Q3 delta=0）、T3（其他）
• delta：消融實驗的 delta 值

退役前確認：

1. 讀取 skill 內容，摘要給使用者
2. 確認使用者同意退役

退役前影響分析（依據：ITIL CMDB Reconciliation）：

在使用者確認前，先執行影響分析，確認此 skill 是否被其他地方引用：

# 搜尋其他 skills 是否引用此 skill
grep -r "<skill-name>" ~/.claude/skills/learned/ --include="*.md" -l
# 搜尋 rules 中是否引用
grep -r "<skill-name>" ~/.claude/rules/ --include="*.md" -l 2>/dev/null
# 搜尋 CLAUDE.md 中是否引用
grep -r "<skill-name>" ~/.claude/CLAUDE.md 2>/dev/null
grep -r "<skill-name>" "$(pwd)/CLAUDE.md" 2>/dev/null

整理影響分析結果：

若有引用存在，向使用者展示影響清單，讓使用者決定是否繼續退役。

Step 3: 復原 Skill

~/.claude/scripts/skills-triage.sh restore <name>

復原後驗證 skill 檔案回到 ~/.claude/skills/learned/。

Step 4: 批次處理

當使用者提供消融數據（如 full-analysis.json）時：

1. 讀取數據，篩選 delta < 0 的 skills
2. 按 delta 絕對值排序
3. 建立「退役 manifest」（依據：DAMA-DMBOK Completeness） 退役 manifest 格式： Skill Delta Tier 依賴關係 狀態 skill-a.md -0.23 T1 無 PENDING skill-b.md -0.10 T2 skill-c 引用 PENDING（需確認）

- 對每個待退役 skill 執行 Step 2 的影響分析（grep 搜尋引用） - 有依賴關係的 skill 標記 PENDING（需確認），不可批次自動退役 - 無依賴關係的 skill 可批次逐一確認後退役

1. 逐一確認後退役，每次退役後更新 manifest 狀態：DONE 或 SKIPPED

Step 5: 退役後完整性驗證（依據：ITIL CMDB Reconciliation）

批次退役完成後，執行驗證確保退役動作已正確完成：

驗證已退役的 skill 不再出現於 learned/ 目錄：

# 對每個 manifest 中狀態為 DONE 的 skill，確認已不在 learned/ 中
ls ~/.claude/skills/learned/<skill-name>.md 2>/dev/null && echo "FAILED: 仍存在" || echo "PASS: 已移除"

驗證 RETIRED_LOG.md 已更新：

# 確認每個退役的 skill 名稱出現在 RETIRED_LOG.md 中
grep -c "<skill-name>" ~/.claude/skills/retired/RETIRED_LOG.md

退役驗證摘要（checklist-driven，依據：OpenAI Developer Community 共識）：

驗證失敗項目需人工介入，不可視為退役完成。

關鍵路徑