RCF-038 — 查照已讀清單強制完整讀取 + IMP-117 表格 Preview 升規
類型:規則變更 日期:2026-05-06 觸發條件:條件 1(修改 HARD STOP 規則)× 2 個 相關文件:
CLAUDE.md(主規則:已讀清單格式 + 合規層③)knowledge/improvements.md(IMP-117 狀態更新)
問題背景
問題一:已讀清單「⚠️ 未讀→待執行」格式缺陷
RCF-035(2026-05-04)建立「已讀清單先行」機制,意圖讓 Tim 在批准執行計畫前能看到所有現況依據的工具調用來源。但格式設計中保留了「⚠️ 未讀→對應查照結果欄標【未驗假設】」這個例外路徑,導致查照中大量必讀文件以「待執行」標記,實際未讀。
Session 133(2026-05-06)Tim 看到一份查照,其中:
hr/inventory.json— ⚠️ 未讀(待執行)reports/system-deep-review.md— ⚠️ 未讀(待執行)knowledge/architecture.md— ⚠️ 未讀(待執行)knowledge/analyses/README.md— ⚠️ 未讀(待執行)
Tim 直接指出:「有發現未讀的清單,就應該先讀取好,才做判斷分析,不是應該這樣嗎」
根本問題:「已讀清單」被誤用為「計畫清單」。Tim 在批准執行計畫時,依據是未讀文件的假設分析,而非實際讀取後的判斷。查照失效。
問題二:IMP-117 表格 Preview 空洞(出現次數達升規閾值 2)
兩次查照中出現表格/矩陣形式的 preview,但格子內容只有欄位名稱、空格或「待分析」,Tim 仍然無法判斷計畫內容。合規層③「文件/規則預覽已展示」的框架下,表格存在 ≠ 預覽完成。
考慮過的方案
問題一:已讀清單格式修正
| 方案 | 描述 | 優點 | 缺點 | 採用? |
|---|---|---|---|---|
| 方案 A:保留「⚠️ 未讀」標記,但要求說明影響程度 | 允許列出「未讀」,但每行附加「影響計畫判斷的項目:XXX」 | 維持透明度 | 仍允許在依據不完整時輸出查照,問題根本未解決 | ❌ |
| 方案 B:完全禁止「⚠️ 未讀」標記,要求所有文件讀完後才輸出 | 所有列入已讀清單的文件必須在查照輸出前實際讀取 | 查照依據完整,Tim 批准有效 | 若文件不存在或無法讀取,需有替代說明機制 | ✅ 採用 |
最終方案:方案 B + 補充說明——若文件無法讀取(不存在/無法存取),在查照結果表中直接標注「【無法取得,影響:XXX】」,由 Tim 判斷是否仍授權執行。
問題二:表格 Preview 強化
唯一方案:在合規層③中明文規定表格/矩陣每格需有 ≥ 1 句實質描述。
最終決策
決策一:已讀清單格式全面修正
- 查照格式模板(完整查照格式章節):移除「⚠️ 未讀→對應查照結果欄標【未驗假設】」,改為「狀態欄只允許 ✅ 已讀」
- 新增說明:「『本次已讀文件清單』為實際讀取記錄,非計畫清單。列入此表的文件必須在查照輸出前已完成讀取」
- 新增例外路徑:文件無法取得時,在查照結果表標注【無法取得,影響:XXX】,不允許在已讀清單中以「⚠️ 未讀」帶過
決策二:IMP-117 升規
- 合規層③ 末尾新增:表格/矩陣 preview 每格需 ≥ 1 句實質描述,空格 = 合規層③未通過
影響範圍
| 影響類型 | 具體項目 |
|---|---|
| 修改文件 | CLAUDE.md — 完整查照格式模板(已讀清單格式說明)+ 合規層③(表格 preview 規則)+ 版本號 v1.8→v1.9 |
| 修改文件 | knowledge/improvements.md — IMP-117 狀態 🔄→✅ 已升規 |
| 觸發部門同步 | 不觸發(改動為已讀清單格式說明,非收尾規則本體;部門 CLAUDE.md 收尾規則指向主 CLAUDE.md) |
驗證方式
下一次查照中:
- 「本次已讀文件清單」表格的狀態欄全部為 ✅(無「⚠️ 未讀」)
- 列入表格的文件必定有對應工具調用記錄(Read/Grep/Glob)
- 查照中出現表格/矩陣 preview 時,每格有 ≥ 1 句實質描述
- Tim 可以直接批准查照,不需再追問「這幾個文件還沒讀是怎麼回事」