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

RCF-014 — 知識存檔架構升規:Learning SOP 三步存檔 + knowledge/analyses/ 建立

RCF 類型:核心 SOP 執行步驟修改(Condition 4) 建立日期:2026-04-27 狀態:已採用


問題背景

觸發事件

Tim 在 2026-04-27 對話中指出:LINE 資料庫連結與對話貼入連結分析後,只在當次對話中使用,未有完整存檔為可再利用的知識資產。具體而言:

  • conversation-pasted URL 流程(web/yt-learning-sop.md):八維分析只寫入 condensed entry(約 10 行)進 knowledge/references/[category].md,完整分析內容(維度 1-8 全文)在 context 消失後永久喪失
  • LINE 資料庫流程:sync.py 已寫入 H-N 欄位至 references/*.md,但只是部分摘要;完整分析也未建立獨立存檔

問題的結構性成因

維度 8 設計之初的目標是「快速存入可瀏覽的 condensed entry」,但沒有考量「事後可搜尋、可引用完整分析」的需求。每次分析等同一次性消費,無法累積為組織知識。


需求確認(Tim 的 4 個問題回覆)

問題 Tim 的回覆 設計含義
Q1:再利用的具體場景 D(以上皆是) 需要:active surfacing + 可搜尋 + 有索引 + Claude 主動引用
Q2:哪個缺口優先 兩個一起設計 web/yt SOP 同步升規
Q3:存檔動作接受方式 完整存下來,避免資料不完整 分析過程中自動存,無額外步驟
Q4:存檔深度 完整八維分析逐字存 不壓縮、不改寫,全文存入

方案對比

方案 描述 優點 缺點 採用?
方案 A:擴充 category .md 直接在 references/[category].md 每條目放完整 8 維度 單一位置,不需新資料夾 category .md 每份數萬字,Grep 速度慢;分類瀏覽與深度分析混在一起
方案 B:獨立 analyses/ 資料夾 + 主索引 完整分析放獨立 .md;condensed entry 留在 category .md 並加連結;有 index.md 主索引 可搜尋、可瀏覽、不影響現有 category .md 結構 每次多 2 個存檔動作(Step B + C)

方案 B 路徑選擇knowledge/analyses/(放在 knowledge/ 根目錄,而非 references/ 子目錄)

理由:SYS-08 知識庫網站只讀 knowledge/references/,若放在 references/analyses/ 可能被網站的 [category]/[slug] 路由誤識別;放在 knowledge/analyses/ 可完全避免此風險。


採用決策

核心變更:維度 8 三步存檔架構

(執行八維分析後)
   ↓
Step A:condensed entry → knowledge/references/[category].md
         (格式升規:新增「完整分析」連結行)
   ↓
Step B:完整八維分析逐字 → knowledge/analyses/YYYY-MM-DD-[slug].md
   ↓
Step C:索引一行 → knowledge/analyses/index.md(<!-- ANALYSIS INDEX --> 之前)

受影響文件清單

文件 修改性質
knowledge/operations/web-learning-sop.md 維度 8 重寫為三步格式 + condensed entry 新增連結行 + 品質自查 1→3 checkbox
knowledge/operations/yt-learning-sop.md 維度 8 重寫為三步格式 + 新增 condensed entry 格式定義 + 品質自查 1→3 checkbox
knowledge/analyses/index.md 新建(forward-only 主索引)
knowledge/analyses/YYYY-MM-DD-[slug].md 每次分析後新建(未來)
knowledge/CLAUDE.md 文件索引新增 analyses/index.md + 輸出管控補 active surfacing 說明
CLAUDE.md 知識庫情境觸發規則表新增「外部知識參考任務前」觸發行
knowledge/architecture.md 路徑 [2] 更新為三步描述

未採用的相關變更

  • LINE 資料庫 H-N 欄位升規:需先讀 sync.py 現有輸出格式才能設計修法,defer 為 P2 任務,本次不修改 sync.py 或 GitHub Actions
  • yt-learning-sop.md 維度 8 完整格式(舊版無 condensed entry 格式定義)→ 本次補入格式定義,兩個 SOP 格式對齊

存檔起點與 retroactive 說明

  • Forward-only:所有 2026-04-27 之前已完成的八維分析,其完整內容已隨 context 壓縮消失,無法回溯
  • knowledge/analyses/index.md 明確標注「存檔起點:2026-04-27」
  • 舊的 condensed entry 在 category .md 維持原狀,不強制補「完整分析」連結行(舊條目無對應分析檔案)

驗收標準

  • 下次 Tim 貼入 URL 時,自動產生 3 個存檔動作(Step A/B/C 均完成)
  • knowledge/analyses/index.md 有新增一行
  • knowledge/analyses/YYYY-MM-DD-[slug].md 完整存在且包含所有 8 維度
  • SYS-08 知識庫網站不顯示 analyses/ 相關內容(確認路由隔離有效)

最近修改記錄

日期 修改內容 狀態
2026-04-27 初版建立(Condition 4 觸發:修改 web/yt-learning-sop.md 核心執行步驟)
← 返回 決策記錄