RCF-003 — 諮詢前分析 SKILL 全面升規（Brief → 七段完整分析）
類型：SKILL 日期：2026-04-23 觸發條件：條件 4 — 修改現有 SKILL 的核心執行步驟（由 5 步驟升至 7 步驟；輸出格式由簡式 Brief 升至七段完整分析文件） 相關文件：
.claude/skills/諮詢前分析.md（主要修改對象，v1.0 → v2.0）crm/CLAUDE.md（新增 consultation-prep/ 存檔說明）crm/consultation-prep/C-202604-001-2026-04-24.md（首次實測產出）
問題背景
諮詢前分析 SKILL 在 2026-04-23 完成首次實測（客戶：C-202604-001，12 個客戶問題，4 條職涯路徑）。
測試過程中發現舊版 SKILL 存在以下結構性問題：
客戶問題沒有完整覆蓋：舊設計沒有要求逐題整合，執行時可能因時間假設略過部分問題（Q1–Q12 中任一題略過 = 諮詢準備不完整）
輸出深度不足以支撐諮詢：「會前 Brief」格式偏向摘要，難以讓 Tim 在諮詢中靈活調度。真正需要的是：Tim 能直接援引的分析依據，而非概括性指引
市場資料缺乏查證機制：舊版未要求執行 WebSearch，市場數字可能引用過時資料（例：台南行銷薪資中位數、南科作業員薪資）
參考順序不明確：沒有規定「知識庫 → 網路即時資料 → 判讀整合」的優先順序，容易直接用 Claude 訓練資料作為事實依據
確定度不透明：沒有 [確定]/[推論]/[待確認] 標記機制，Tim 無法在諮詢中快速判斷哪些資訊需要當場求證
輸出只有對話，無長期存檔：諮詢準備分析沒有固定存檔路徑，無法在後續回訪或方法論改進中引用
考慮過的方案
| 方案 | 描述 | 優點 | 缺點 | 採用？ |
|---|---|---|---|---|
| 方案 A（維持現況） | 保留舊版 5 步驟 Brief 格式，僅補強客戶問題覆蓋要求 | 執行快、負擔小 | 無法解決深度不足、確定度不透明、存檔缺失等問題 | ❌ 未採用 |
| 方案 B（局部升規） | 增加問題覆蓋要求 + 確定度標記，輸出格式保持 Brief | 折衷方案，保留輕量感 | 仍未解決市場資料時效問題與長期存檔問題，重複建立不完整的框架 | ❌ 未採用 |
| 方案 C（全面升規，最終採用） | 重新設計為七段完整分析文件：客戶概況 / 資料缺口 / 市場現況（WebSearch）/ 個人評估（逐題整合）/ 探索方向 / 風險提示 / 方法論 / 結論；輸出至 3 個位置（MD 存檔 + Word 版 + 對話摘要） | 完整解決所有問題；首次實測成功驗證可行性；Word 版讓 Tim 在諮詢現場有格式化材料可用 | 執行時間較長（約需 25–40 分鐘）；需要 WebSearch 工具支援 | ✅ 採用 |
最終決策
採用方案 C（全面升規）。
核心理由：諮詢準備文件的價值在於「讓 Tim 在諮詢中更有信心、更有依據」。Brief 格式在這個目標上先天不足——它只告訴 Tim「大概往哪個方向」，但無法提供「為什麼」的具體支撐。
在首次實測（C-202604-001）中，七段完整分析格式成功完成了：12 個問題逐題分析、台灣台南市場即時薪資資料查證、確定度標記、三個逐字可用的探索問題。Tim 確認執行後的輸出「完整、詳細、嚴謹」。
方案 A 和方案 B 被排除的原因：改了一半比沒改更混亂，舊的問題會繼續拖累諮詢品質。
影響範圍
| 影響類型 | 具體項目 |
|---|---|
| 修改 SKILL | .claude/skills/諮詢前分析.md（v1.0 → v2.0）：步驟 5→7（+Step 4 讀六大框架、+Step 5 重讀客戶文件含細節清單、+Step 6 WebSearch 市場資料）；輸出規範新增七段格式定義、三處存檔規定、確定度標記系統、品質標準 5 條；狀態 ⏳ → ✅ |
| 修改 CLAUDE.md | crm/CLAUDE.md：存檔規定章節新增「諮詢前文件」子節，說明 consultation-prep/ 路徑、KPI 豁免、Word 版路徑規則 |
| 新增文件（存檔） | crm/consultation-prep/C-202604-001-2026-04-24.md（首次實測輸出，七段完整分析，去識別化存檔） |
| 新增文件（Word） | C:\Users\USER\Desktop\Company\諮詢\Amber_260424\石雅瑜_諮詢前分析_20260424.docx（格式化版，諮詢當天使用） |
| 新增腳本 | scripts/gen_consult_doc.py（python-docx Word 生成腳本，含色彩樣式、表格、確定度標記格式） |
| 影響流程 | crm/ 存檔流程：consultation-prep/ 新增為獨立子目錄，與 client-log.md（諮詢結果記錄）並列但不互相影響 |
驗證方式
下次執行 諮詢前分析 [客戶代號] 時，應能觀察到：
- Claude 自動執行 7 個步驟（含 Step 4 讀六大框架、Step 6 WebSearch）
- 輸出包含七段完整格式，Q1–Q[最後題號] 全部逐題分析（無略過）
- 每個評估結論附有 [確定]/[推論]/[待確認] 標記
- 市場資料（Section 3-A）引用 WebSearch 結果，並標注可信度與來源
- 產出 3 個存放位置：MD 檔（crm/consultation-prep/）、Word 檔（客戶資料夾）、對話摘要（Section 1 + 3-B 摘要 + Section 6）
crm/consultation-prep/有對應日期的 .md 檔案
回歸測試觸發：第二次實際諮詢前執行時，由外稽部確認上述 6 項均達標。