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

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)

驗證方式

下一次查照中:

  1. 「本次已讀文件清單」表格的狀態欄全部為 ✅(無「⚠️ 未讀」)
  2. 列入表格的文件必定有對應工具調用記錄(Read/Grep/Glob)
  3. 查照中出現表格/矩陣 preview 時,每格有 ≥ 1 句實質描述
  4. Tim 可以直接批准查照,不需再追問「這幾個文件還沒讀是怎麼回事」
← 返回 決策記錄