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 核心執行步驟) | ✅ |