SKILL 整合評估八維框架（Skill Integration Review Checklist）
建立日期：2026-06-01 文件狀態：有效 v1.0 用途：任何 SKILL 設計評估、整合評估前，逐維度掃完後輸出完整 Gap 清單；禁止以開放式追問替代框架掃描 觸發時機：查照中「執行計畫」包含修改 SKILL 文件 / 新增 SKILL step / 設計新 SKILL 流程時 來源：IMP-156 第 2 次出現（2026-06-01）——4 輪補漏後萃取為預建框架
使用方式
- 開始評估前先宣告：「依八維框架逐維度掃描」
- 逐維度填入發現（有/無問題均記錄）
- 彙整完整 Gap 清單後一次輸出
- 不允許「想到再補」——框架掃完即為完整
八維框架（A-H，MECE）
A. 資料流（Data Flow）
自問：每個輸入從哪裡來？流向哪個輸出？有無斷路、資料遺失、格式不符？
掃描項目：
- 所有輸入來源已列出（檔案 / 使用者貼入 / API 回傳）
- 每個輸入到對應輸出的路徑清楚（Q→Section 的對應關係）
- 輸出有無去識別化需求？時機是否定義？
- 輸出同步到哪些下游文件？（consultation-prep / client-log / tasks.md 等）
B. 分支窮舉（Branch Exhaustion）
自問：所有條件分支是否完整列出？每條路徑都有明確出口？
掃描項目：
- 主路徑（找到 / 成功）已定義
- 備用路徑（未找到 / 失敗 / 部分）已定義
- 邊界情境已列出（S0 vs S4/S6 / DIAG + intake 共存 / 空白答案 / 多檔案取最新）
- 所有分支出口均有明確動作（不允許「無動作」空路徑）
C. 生命週期（Lifecycle）
自問：SKILL 執行前 / 中 / 後，Tim 的操作鏈完整嗎？有無 SOP 空白？
掃描項目：
- 前置：Tim 需要做什麼準備（存檔 / 轉換格式 / 命名規則）？
- 執行中：SKILL 對 Tim 的依賴是否明確說明？
- 執行後：結果怎麼驗證？需要 Tim 再做什麼？
- 長期：此 SKILL 新增後，對定期流程（週報 / 月報 / 季度盤點）有影響嗎？
D. 與其他 Step 的交點（Step Integration）
自問：新增 Step 的輸出如何影響後續 Step？有無需要傳遞的上下文？
掃描項目：
- 新 Step 的輸出是否需要後續 Step 明確引用？
- 後續 Step 的查詢語境是否需要更新（如 NotebookLM 查詢帶入新推斷）？
- 新 Step 與現有 Step 的執行順序是否正確且明確？
- 新 Step 若失敗 / 跳過，後續 Step 如何調整？
E. 人為因素（Human Factors）
自問：Tim 在實際操作時可能遇到什麼問題？有無未定義的手動步驟？
掃描項目：
- Tim 需要做的事情是否逐步說明（無需特殊技能）？
- 命名規則 / 日期定義 / 格式規格是否明確（Tim 第一次使用不會卡）？
- 有無「Tim 可能用錯格式」的情境？Glob / 讀取如何應對？
- Tim 是否有 fallback 路徑（貼入 vs 存檔 / 問卷未收到時怎麼辦）？
F. 錯誤與邊界（Error & Edge Cases）
自問：資料異常、路徑不存在、格式錯誤時，SKILL 如何處理？
掃描項目：
- 檔案不存在（workspace / 問卷檔案）→ 靜默略過 / 警告 / 中止？
- 檔案存在但為空白 → 如何處理？
- 檔案格式不符預期（Tim 貼錯內容）→ 如何應對？
- 多個符合條件的檔案 → 取哪一個？規則是否明確？
G. 輸出格式規格（Output Format Specification）
自問：SKILL 的輸出格式有無具體示例？Tim 能否驗收？
掃描項目：
- 有輸出格式示例（非只說「補入 Section X」）？
- 各情境的輸出格式是否分別定義（找到 / 未找到 / 貼入）？
- 格式中的確定度標記（[確定] / [推論] / [待確認]）是否明確？
- 特殊標注（P-type 初步訊號、去識別化摘要）的呈現方式是否示例？
H. 下游文件同步（Downstream Document Sync）
自問：修改 SKILL 後，哪些其他文件需要同步更新？
掃描項目：
-
knowledge/operations/consultation-sop-complete.md（或對應完整 SOP）是否需要同步？ - 對應部門 CLAUDE.md 的存檔規定子節是否需要新增或更新？
-
knowledge/operations/commands-reference.md的指令/描述是否需要更新？（狀態欄已於 C07 移除，SKILL 狀態唯一來源為主 CLAUDE.md SKILL 表） - 主 CLAUDE.md SKILL 表的描述 / 狀態是否需要更新？
- 新 SKILL step 的存儲路徑 / 命名規則是否在主規則文件（crm/CLAUDE.md 等）中有定義？
快速參考：SKILL 整合常見 Gap 類型
| Gap 類型 | 所屬維度 | 檢查問題 |
|---|---|---|
| 「最新一份」未定義取法 | B / F | Glob 多結果時取哪個？ |
| P-type 推斷未標 [推論] | G | 初步訊號和最終確認要分開標注 |
| 去識別化時機不明 | A | 原文在哪個 Step 去識別化？ |
| 共存情境分區不清 | B / G | 兩種資料來源同時存在如何呈現？ |
| S0 誤觸警告 | B | 不適用客戶誤觸條件判斷的情境 |
| 空白答案處理 | F | 必填題空白如何標注？ |
| Tim 貼入 vs 存檔 fallback | E | 未存檔時有無替代輸入路徑？ |
| 已讀確認輸出缺失 | G | 讀到什麼檔案要明確說出來 |
| Workspace 不存在混淆 | B / F | 目錄不存在 vs 問卷未寄是不同問題 |
| 存檔 SOP 不完整 | C / E | Tim 日期定義、命名格式未說明 |
| Q3/Q5/Q6 未補入下游 Section | A / D | 資料應流向多個 Section |
| NotebookLM 查詢未帶入新訊號 | D | 步驟間上下文傳遞 |
| consultation-sop-complete.md 未同步 | H | 下游文件同步 |
| 部門 CLAUDE.md 存檔規定未更新 | H | 下游文件同步 |
⚠️ 使用限制：本框架針對「現有 SKILL 整合新 step」最佳化。新建整個 SKILL 時，應額外補充：觸發詞設計 / 輸入清單 / 存放路徑 / 品質標準 / 完整說明文件 等維度（詳見
.claude/skills/SKILL評估.md）。