RCF-056:SKILL 知識庫更新步驟補建(會議整理 + 諮詢完成)
基本資訊
| 欄位 | 內容 |
|---|---|
| 類型 | Condition 4(新增 / 修改 SKILL 核心執行步驟) |
| 日期 | 2026-05-27 |
| 觸發條件 | 修改兩個 SKILL 的核心執行步驟(會議整理.md Step 6 新增 + 諮詢完成.md Step 3 升規) |
| 相關文件 | .claude/skills/會議整理.md、.claude/skills/諮詢完成.md、knowledge/client-patterns.md |
問題背景
執行 C-202605-001(Claire,2026-05-21)與 C-202605-002(Olivia,2026-05-22)兩次諮詢後,發現兩筆客戶的洞察均未寫入 knowledge/client-patterns.md。追溯根因後確認:
雙層問題:
- 流程設計缺口:
會議整理.md只有 5 個步驟,Step 4 提取 insight 後直接到 Step 5 生成 CRM 草稿,完全沒有「寫入 client-patterns.md」步驟。 - 輕流程執行缺口:
諮詢完成.mdStep 3 雖有「輸出回憶提示問題」意圖,但問完後沒有「→ 根據 Tim 回答寫入知識庫」的後續動作。
兩個 SKILL 都假設「問了 Tim,Tim 記得去更新」,但沒有任何強制閉環機制。
知識庫觸發規則背景: 主 CLAUDE.md 知識庫情境觸發規則表中,「諮詢後記錄客戶洞察」未標 ⛔,屬於「強烈建議」而非 HARD STOP。但正因此,若 SKILL 本身未設計閉環,Claude 在 SKILL 執行中缺乏獨立觸發依據——這是設計缺口,而非執行態度問題。
考慮方案
方案 A:升規主 CLAUDE.md 知識庫觸發規則(加 ⛔ 標記)
- 優點:讓規則本身更明確強制
- 缺點:主規則變更影響範圍廣,且問題根源是 SKILL 步驟設計,而非規則層缺失
方案 B:在 SKILL 執行步驟內建閉環(採用)
- 會議整理.md:新增 Step 6(必填,不得省略):讀取 client-patterns.md → 判斷新 pattern / 確認案例 / 無新洞察三分支 → 寫入或明確輸出理由
- 諮詢完成.md:升規 Step 3(Tim 回答後必填):新增「→ Tim 回答後立即讀取並寫入(或輸出無新 pattern 理由)」
- 優點:閉環在 SKILL 執行步驟內完成,不依賴 Claude 主動記得;格式與 IAUD 合規層「不省略 = 違規」邏輯一致
- 缺點:每次諮詢多一個步驟(可接受,屬於正確的工作量)
最終決策
採用方案 B。
SKILL 執行步驟需要自給自足——不能假設執行者在步驟結束後會記得做其他事。知識庫更新是諮詢工作閉環的一部分,應內嵌於 SKILL 步驟,而非留在「強烈建議」的外部規則。
執行變更
1. 會議整理.md — 新增 Step 6(必填)
新增於原 Step 5(生成 CRM 草稿)之後:
6. **寫入 `knowledge/client-patterns.md`(必填,不得省略)**
- 讀取 `knowledge/client-patterns.md` 確認現有 pattern 分類
- 判斷本次洞察屬於以下哪種情況:
- **新 pattern**:新增完整條目(現象 + 根本原因 + 有效回應 + 診斷提示 + 適用對象 + 首次記錄)
- **現有 pattern 的確認案例**:在對應條目「首次記錄」行之後補充「**第 N 次確認案例**」
- **無新洞察**:明確輸出「知識庫更新:本次無新 pattern,理由:XXX」(空白 = 違規)
- 更新文件頭部「最後更新」行與底部修改記錄表格
2. 諮詢完成.md — 升規 Step 3
原:輸出回憶提示問題,協助 Tim 萃取洞察 改:輸出回憶提示問題 → Tim 回答後,根據回答立即寫入 client-patterns.md(或輸出「無新 pattern,理由:XXX」)
3. 補行補漏(同次對話執行)
- C-202605-002(Olivia):G-02 停損框架決策型第二確認案例補入 client-patterns.md
影響範圍
| 影響項目 | 說明 |
|---|---|
.claude/skills/會議整理.md |
Step 6 新增(共 6 步驟) |
.claude/skills/諮詢完成.md |
Step 3 升規(新增 Tim 回答後強制寫入邏輯) |
knowledge/client-patterns.md |
G-02 第二確認案例補入;最後更新行更新 |
| 未來諮詢執行 | 兩個 SKILL 觸發時,知識庫更新成為步驟的一部分,不再依賴 Claude 主動記得 |
驗證方式
下次執行「會議整理」或「諮詢完成」SKILL 時:
- 執行到對應步驟時,Claude 主動讀取 client-patterns.md
- 依三分支邏輯(新 pattern / 確認案例 / 無新洞察)輸出結果
- 若有寫入,確認文件頭部「最後更新」行同步更新