📚職涯停看聽・知識庫← 總部儀表板
📅最後更新:2026/06/08
📑 目錄

RCF-055 — SKILL 技能包生命週期健檢機制建立

類型:SKILL 日期:2026-05-26 觸發條件:條件 4 — 修改 SKILL 評估.md、季度盤點.md、健康檢查.md 三個 SKILL 的核心執行步驟;同時新增跨 SKILL 生命週期管理機制(防膨脹、廢止候選、整併評估、衝突預檢) 相關文件

  • .claude/skills/SKILL評估.md(Step 3.5 + Step 4.5 新增)
  • .claude/skills/季度盤點.md(Step 2.5 → 2.5a + 新增 2.5b 全面健檢)
  • .claude/skills/健康檢查.md(Step 3.5 SKILL 健康度快速摘要新增)
  • CLAUDE.md(SKILL 表狀態說明 legend 新增 🕐 / 🗃️;電子報、知識掃描 ⏳→✅)
  • knowledge/CLAUDE.md(.claude/skills/ 非 Tim 觸發文件分類說明新增)

問題背景

隨著工作室 SKILL 數量從早期 10 個成長到 37 個(含 plugin 7 個),發生了三種可預期的腐化模式:

  1. 狀態漂移:SKILL 表中標記 ⏳(待驗證)的條目,實際上已有使用記錄,但系統未同步修正。2026-05-26 本次確認,「電子報」與「知識掃描」均已實際使用,但仍標 ⏳,為典型案例。

  2. 廢止候選積累:部分 ⏳ SKILL 設計完成後超過 90 天從未觸發,形成「沉默 SKILL」——佔用 CLAUDE.md 情境偵測表空間、增加 Context Window 負擔、Tim 也不記得有此 SKILL。

  3. 功能重疊與膨脹風險:每次有新需求就建新 SKILL,未評估現有 SKILL 強化是否已可解決,導致觸發詞語意相近的 SKILL 並存,增加 Tim 觸發時的困惑。

這三個問題的共同根源:SKILL 只有「建立」流程,沒有「老化複查」流程

靈感來源:江江 AI 辦公室「技能包大總管」概念(參見 tasks.md 任務描述 L189)。


考慮過的方案

方案 描述 優點 缺點 採用?
方案 A:在 SKILL評估 加入①②③ 將觸發詞衝突偵測(①)、廢止候選清單(②)、整併評估(③)全部加入 SKILL評估 SKILL 集中在一個地方 ②③ 需要全面定期掃描,放在「新增 SKILL 時才跑」的 SKILL評估 = 永遠不會對已有 SKILL 做健檢 ❌ 未採用
方案 B(最終採用):雙路徑拆分 ① 衝突預檢 + ④ 防膨脹 → SKILL評估(新增時執行);②③ 廢止候選 + 整併評估 → 季度盤點 Step 2.5b(定期全面執行);健康檢查加輕量 SKILL 計數摘要 觸發頻率對齊任務性質(新增時做衝突+膨脹;季度做全面健檢);健康檢查可持續提供 SKILL 健康度快速可見性 分散在三個 SKILL,需要交叉指針確保不遺漏 ✅ 採用
方案 C:新建獨立 SKILL「SKILL管理員」 建立獨立的 SKILL 生命週期管理 SKILL 乾淨、職責單一 又新增一個 SKILL,違反防膨脹原則;現有三個 SKILL 已有足夠入口 ❌ 未採用

方案 B 另有一個關鍵設計問題需解決:季度盤點 Step 2.5b 本身是 ⏳(從未實際觸發),如果生命週期健檢只嵌在季度盤點裡,就是「需要用 ⏳ SKILL 來管理 ⏳ SKILL」的循環依賴。解法:健康檢查(✅ 已驗證、高頻)提供輕量快速摘要作為持續可見性;季度盤點提供深度全面診斷。兩者互補形成雙路徑。


最終決策

採用方案 B 雙路徑架構:

  1. SKILL評估.md 新增 Step 3.5(防膨脹自查)和 Step 4.5(觸發詞衝突預檢),確保每次新增 SKILL 前都經過這兩道門檻
  2. 季度盤點.md Step 2.5 重命名為 2.5a(規則老化複查,原有內容保留),新增 2.5b(SKILL 生命週期全面健檢,八項子任務 + 廢止執行三路徑 + 雙路徑設計說明)
  3. 健康檢查.md 新增 Step 3.5(SKILL 健康度快速摘要),每次健康掃描時輸出四種狀態計數,⏳ > 30% 或有 🕐 時觸發警示
  4. CLAUDE.md SKILL 表 新增 legend 標記(🕐 stale >90 天;🗃️ 已歸檔);修正兩個狀態漂移(電子報、知識掃描 ⏳→✅)
  5. knowledge/CLAUDE.md 補充 .claude/skills/ 非用戶觸發文件(LINE-mapping.md、品牌分析-detail.md)的分類說明,避免季度盤點健檢時誤計這些文件為「未登記 SKILL」

影響範圍

影響類型 具體項目
修改文件 .claude/skills/SKILL評估.md(+Step 3.5 防膨脹 + Step 4.5 衝突預檢)
修改文件 .claude/skills/季度盤點.md(Step 2.5→2.5a 保留;新增 2.5b 全面健檢八項)
修改文件 .claude/skills/健康檢查.md(新增 Step 3.5 SKILL 健康度快速摘要)
修改文件 CLAUDE.md(legend 新增 🕐/🗃️;電子報/知識掃描 ⏳→✅)
修改文件 knowledge/CLAUDE.md(核心職責 5 補充 .claude/skills/ 非用戶觸發文件分類說明)
建立文件 knowledge/decisions/RCF-055.md(本文件)
影響的 SKILL SKILL評估、季度盤點、健康檢查

RCF 觸發矩陣新增說明(本次明確化但未寫入規則的隱含範疇):

  • SKILL 觸發詞更改 → 觸發 RCF 條件 4(核心步驟修改的延伸)
  • SKILL 整併(兩 SKILL 合一)→ 觸發 RCF 條件 4
  • SKILL 歸檔(廢止)→ 不觸發 RCF(format-level 操作,等同格式修改)

驗證方式

  1. SKILL評估 執行時:輸出中出現「Step 3.5 防膨脹自查」段落,且有「確實需要獨立 SKILL → 繼續 Step 4」判斷
  2. 季度盤點執行時:Step 2.5b 輸出格式包含「總 SKILL 數:✅ N 個 / ⏳ N 個 / 🕐 N 個 / 🗃️ N 個」統計
  3. 健康檢查執行時:報告中出現「SKILL 健康度快速摘要」區塊,有四種狀態計數
  4. 下次 SKILL 表狀態漂移發生時:可透過季度盤點 Step 2.5b ② 的 daily-log grep 發現並修正
← 返回 決策記錄