RCF-089 — 偏科健康指標 B 公式修正(syntheses/ vs analyses/ 計入澄清)
使用方式:本文件記錄 RCF-087 偏科健康指標 B 公式設計缺陷的修正決策。
類型:SKILL 日期:2026-06-16 觸發條件:條件 4 — 修改知識編譯 SKILL 核心執行步驟(Step 4 新增交叉索引步驟 + 月底 check C2/C2.5/C4 公式) 相關文件:
.claude/skills/知識編譯.md(Step 4 步驟 5 新增 + Step C2/C2.5/C4)knowledge/analyses/README.md(說明區 + methodology-synthesis 交叉索引行).claude/skills/整理知識庫.md(C. 主題分佈健康檢查類別標籤)strategy/post-consultation-sop.md(接點 3 連結說明)knowledge/CLAUDE.md(知識迴路描述)knowledge/decisions/RCF-087-methodology-bias-self-correction.md(被修訂者,補 3 處修訂註記)
問題背景
RCF-087(KM-Phase4)設計偏科健康雙指標:
- 指標 A(節奏,可控):距上次「職涯顧問」群集合成天數
- 指標 B(佔比,觀測):
grep -c "methodology-analysis" analyses/README.md÷ 總條目數
設計缺陷:指標 B 的公式假設「知識編譯 職涯顧問」會產出 methodology-analysis 進 analyses/。但知識編譯 SKILL(RCF-080)實際輸出進 syntheses/(Step 4 Write syntheses/YYYY-MM-DD-[群集名].md,Edit syntheses/README.md + analyses/topic-index.md),從不觸碰 analyses/README.md。
結果:執行 知識編譯 職涯顧問 後,2026-06-15-職涯顧問.md 進了 syntheses/,但 analyses/README.md 的 methodology-analysis 計數毫無變化 → 指標 B 永遠不會因合成層產出而上升,RCF-087 設計的「補存量修偏科」在指標 B 上看不見。
附帶問題:原 grep pattern "methodology-analysis" 為裸字串比對,會誤命中標題/用途標籤欄中出現的「methodology-analysis」字樣(如說明文字),非精確掃類型欄。
信念變更紀錄
| 欄位 | 內容 |
|---|---|
| from(舊認知) | 知識編譯職涯顧問群集 → 產出 methodology-analysis 進 analyses/;指標 B 掃 analyses/README 即可反映合成層偏科修正 |
| to(新認知) | 知識編譯輸出進 syntheses/(命名刻意與 analyses/ 分開,RCF-080 決策 0);指標 B 若只掃 analyses/README 永遠漏計合成層 → 須在 analyses/README 建交叉索引行讓 syntheses/ 產出可見,並以精確 pattern `" |
| trigger(觸發事件) | Tim 指派澄清任務(tasks.md L118)+ 四輪「足夠嚴謹完整嗎」追問 → 全 repo grep 掃描揪出 6 處散落引用(含 post-consultation-sop / 整理知識庫 兩處原計畫外缺口) |
| 信心変化 | +(從「指標公式正確」轉為「讀 SKILL 實際輸出路徑驗證後發現公式失效並修正」,機制可靠性提升) |
考慮過的方案
| 方案 | 描述 | 優點 | 缺點 | 採用? |
|---|---|---|---|---|
| 方案 ① | 指標 B 改計「analyses/ methodology-analysis + syntheses/ 方法論群集合成」雙來源 grep | 不需動 analyses/README | 指標 B 計算需跨兩資料夾 grep,整理知識庫 SKILL 的偏科健康檢查(只讀 analyses/README)仍漏計;syntheses/ 無統一類型欄難精確掃 | ❌ 未採用 |
| 方案 ②(最終採用) | 知識編譯 SKILL 對方法論群集額外在 analyses/README 建 methodology-synthesis 交叉索引行(✦ 指向 syntheses/);指標 B grep pattern 改 `" | methodology-"` 同時涵蓋兩類型 | analyses/README 維持偏科監控的單一儀表板;整理知識庫健康檢查無需改掃描範圍;交叉索引明示合成層產出 | 知識編譯 SKILL 每次方法論群集合成多一個 Edit 步驟 |
最終決策
採用方案 ②。核心:analyses/README.md 維持為偏科監控的單一儀表板,知識編譯輸出方法論群集時,在 Step 4 新增「方法論群集交叉索引」步驟,於 analyses/README 頂部建一行 methodology-synthesis 交叉索引(類型欄 = methodology-synthesis,完整分析檔欄以 ✦ 標記指向 ../syntheses/[檔名].md)。
指標 B 公式 grep -c "methodology-analysis" → grep -c "| methodology-":
- 同時涵蓋 methodology-analysis(手動深度合成,主檔在 analyses/)+ methodology-synthesis(知識編譯交叉索引,主檔在 syntheses/)
"| methodology-"比對類型欄前綴,避免標題/用途標籤欄出現「methodology-」字樣的誤命中
方案 ① 被排除:跨資料夾 grep 無法讓整理知識庫 SKILL 的偏科健康檢查(只讀 analyses/README)正確計入,且 syntheses/ 無統一類型欄。
影響範圍
| 影響類型 | 具體項目 |
|---|---|
| 新增文件 | knowledge/decisions/RCF-089-methodology-bias-indicator-b-formula-fix.md |
| 修改 SKILL | 知識編譯.md(Step 4 步驟 5 新增交叉索引 + Step C2/C2.5/C4 公式與描述);整理知識庫.md(C. 健康檢查類別標籤含 methodology-synthesis) |
| 修改文件 | knowledge/analyses/README.md(說明區 4 類型 + 2026-06-15 回溯索引行);strategy/post-consultation-sop.md(接點 3 連結);knowledge/CLAUDE.md(知識迴路);RCF-087(3 處修訂註記) |
| 觸發部門同步 | 無(未動收尾七件事 / HARD STOP / 查照協議格式 / 五關自查;僅 KM 自身文件 + 1 SOP) |
| 影響的 SKILL | 知識編譯、整理知識庫 |
驗證方式
- 公式運作:
grep -c "| methodology-" knowledge/analyses/README.md回傳 4(3 methodology-analysis:2026-05-13/06-12/06-14 + 1 methodology-synthesis:2026-06-15);指標 B = 4/33 ≈ 12%(2026-06-16 實測) - 交叉索引可達:analyses/README 的 2026-06-15 行 ✦ 連結指向實際存在的
syntheses/2026-06-15-職涯顧問.md - 整理知識庫健康檢查不再誤報:C. 主題分佈統計時,職涯顧問方法論類別計入 methodology-synthesis,類別數 ≠ 0(不觸發 🔴 偽警告)
- 下次知識編譯職涯顧問群集:Step 4 步驟 5 自動在 analyses/README 建交叉索引行,指標 B 隨之上升