RCF-090 — web-learning-sop 多檔來源完整讀取規則（HARD STOP）
使用方式：本文件記錄為 web-learning-sop.md 新增「多檔來源完整讀取」HARD STOP 的決策。
類型：HARD STOP / 修改核心執行步驟 日期：2026-06-17 觸發條件：條件 1（新增 HARD STOP 規則）+ 條件 4（修改 web-learning-sop 核心執行步驟「內容讀取策略」）；Tim 親自指出直接升規（不需等 IMP count ≥ 2） 相關文件：
knowledge/operations/web-learning-sop.md（三、內容讀取策略 新增 HARD STOP + 五、品質自查 +1 條 + 修改記錄）knowledge/analyses/2026-06-17-github-hao0321-claude-skill-social-post.md（觸發案例，補讀全 13 檔後完整化）knowledge/improvements.md（IMP-177 家族第 11 領域）
問題背景
2026-06-17 Tim 貼 GitHub repo Hao0321/claude-skill-social-post 要求「完整分析學習」。第一輪八維分析只讀 repo 主頁 + README，憑描述推斷 F1-F7 公式、R1-R35 規則、語感機制即輸出維度 3 五欄比較與採用點。
Tim 連續追問「足夠嚴謹、詳細、完整嗎」3 次，才逐輪補讀 repo 實際檔案：
- 第二輪補 7 檔（README/SKILL.md/style_profile/learn_style/rules/facebook/instagram）
- 第三輪補剩餘 6 檔（generate_and_publish/case_studies/phase0_plan/evaluation/threads/x + content_plan.example）
補讀後結論大幅修正：多平台自動發文判斷從「不採用」翻轉為「FB Level 2 試行」、補出評估框架概念、補出 P2 發佈執行邏輯與 case_studies 實證層。若 Tim 未追問即採信第一輪分析，知識庫會存入一份不完整且結論錯誤的條目。
附帶根因：維度 2 雖誠實標「次要檔未讀」，但仍輸出帶結論的五欄比較 →「已標記未讀 ≠ 免責」（IMP-111 利刃）。
信念變更紀錄
| 欄位 | 內容 |
|---|---|
| from（舊認知） | 多檔來源（repo）只要讀 README + 主要檔，次要檔標「未讀」即可輸出八維分析；維度 2 誠實標註限制就算盡責 |
| to（新認知） | 多檔來源第一輪即須讀完所有核心內容檔（README+主規格+references/docs 全 .md+範例）；「標註未讀」不能當免責藉口仍下結論；不完整讀取 = 知識庫條目不完整 + 結論可能錯誤 |
| trigger（觸發事件） | Tim 3 次「足夠嚴謹完整嗎」追問 + 第 3 次明確指示「以後學習分析都要全部讀完再分析，知識庫內容才完整」 |
| 信心変化 | +（從「誠實標註限制即可」轉為「完整讀取為輸出前置條件」，知識庫條目可靠性提升） |
考慮過的方案
| 方案 | 描述 | 優點 | 缺點 | 採用？ |
|---|---|---|---|---|
| 方案 A | 維持現狀（讀 README + 主要檔，次要檔標未讀） | 省 token/時間 | 知識庫條目不完整、結論可能錯（本案實證）；靠 Tim 追問補洞 | ❌ |
| 方案 B（採用） | 多檔來源第一輪讀完所有核心內容檔，維度 2 逐檔標 ✅/⚠️，未讀附排除理由 | 知識庫條目完整、第一輪即窮舉、排除透明 | 多檔 repo 讀取成本較高 | ✅ |
| 方案 C | 全 repo 所有檔案無差別讀完（含 LICENSE/.gitignore） | 絕對完整 | 浪費（非內容檔無分析價值） | ❌（折衷為 B：核心內容檔全讀 + 非內容檔附理由排除） |
最終決策
採用方案 B。在 web-learning-sop.md 三、內容讀取策略 新增 HARD STOP「多檔來源完整讀取規則」：
- 觸發：來源為多檔集合（GitHub repo / 含子目錄文件集 / 多頁技術文件 / 主檔+references 結構）
- 第一輪即列出完整檔案清單 + 讀完所有核心內容檔（README+主規格+references/docs 全 .md+範例）
- 維度 2 逐檔標 ✅ 已讀/⚠️ 未讀 + 內容完整性明確宣告
- 未讀核心檔必須附排除理由，禁靜默跳過
- 非內容檔（LICENSE/.gitignore/CHANGELOG/二進位）排除但須說明
品質自查新增對應 checkbox。
影響範圍
| 影響類型 | 具體項目 |
|---|---|
| 新增文件 | knowledge/decisions/RCF-090-web-learning-full-read-rule.md |
| 修改 SOP | web-learning-sop.md（HARD STOP + 品質自查 + 修改記錄） |
| 觸發部門同步 | 無（web-learning-sop 為 KM operations SOP，非主 CLAUDE.md HARD STOP；主 CLAUDE.md 知識庫情境觸發表已指向 web-learning-sop，無需改快速索引） |
| 影響的 SKILL | 無獨立 SKILL 檔；web-learning-sop 由「貼學習 URL」情境自動觸發 |
驗證方式
- 規則存在：
grep "多檔來源完整讀取規則" web-learning-sop.md命中 HARD STOP 區塊 - 品質自查更新：五、分析品質自查含「多檔來源全讀（RCF-090）」checkbox
- 觸發案例完整化：2026-06-17-github-hao0321 分析檔維度 2 內容完整性 = ✅ 完整（13 檔全讀）
- 下次 repo 學習分析：第一輪維度 2 即出現完整檔案清單 + 逐檔 ✅/⚠️ 標記