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

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 知識編譯、整理知識庫

驗證方式

  1. 公式運作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 實測)
  2. 交叉索引可達:analyses/README 的 2026-06-15 行 ✦ 連結指向實際存在的 syntheses/2026-06-15-職涯顧問.md
  3. 整理知識庫健康檢查不再誤報:C. 主題分佈統計時,職涯顧問方法論類別計入 methodology-synthesis,類別數 ≠ 0(不觸發 🔴 偽警告)
  4. 下次知識編譯職涯顧問群集:Step 4 步驟 5 自動在 analyses/README 建交叉索引行,指標 B 隨之上升
← 返回 決策記錄