RCF-035:查照格式強制「已讀清單先行」(方案 C)
基本資訊
- 建立日期:2026-05-04
- 觸發條件:RCF 條件 1(新增 HARD STOP 規則:合規層① 方案 C 子規則)
- 影響範圍:
CLAUDE.md(合規層① + 查照格式模板兩處) - 關聯文件:
knowledge/improvements.md(IMP-111 升規依據);knowledge/decisions/RCF-004-iaud-dual-layer-audit.md(IAUD 框架)
變更摘要
在 CLAUDE.md 兩個位置新增「已讀清單先行」機制:
位置一:合規層① 子規則(IMP-111 之後)
- 新增
⛔ 查照格式強制:已讀清單先行(方案 C,RCF-035,2026-05-04) - 要求查照輸出前必須先填寫「本次已讀文件清單」區塊
- 明確:清單中「✅ 已讀」必須對應本次對話中實際出現的 Read/Grep/Glob 工具調用
位置二:查照格式模板
- 在「查照結果」表格之前插入「本次已讀文件清單」區塊(三欄:文件/讀取工具與範圍/狀態)
- 狀態欄明確標記:
✅ 已讀或⚠️ 未讀→對應查照結果欄標【未驗假設】
WHY(為什麼這樣設計)
根本問題:IMP-111 是隱性要求,沒有可見的執行載體
IMP-111(2026-05-04 升規,出現次數 4 觸發)規定「無對應工具調用 → 標注【未驗證假設】」,但這個要求是隱性的——沒有結構化格式讓 Claude 和 Tim 在查照輸出時「一眼看出哪些現況有對應工具調用、哪些沒有」。
問題在哪裡出現(Session 123 — 直接觸發本 RCF)
Tim 說:「我發現很多次在任務查照時,都沒有讀取該讀取的檔案,我們的管理機制有問題。」
具體失效模式:
- Claude 在查照中以確認語氣陳述現況(「已確認 X 檔案狀態 Y」)
- 但實際未在本次對話中讀取該檔案
- 依賴的是壓縮摘要、記憶、或前次寫入文件的內容
- Tim 批准查照時看不出這些現況「是否有本次工具調用支撐」
三個選項的比較與選擇
| 方案 | 說明 | 被選/排除 |
|---|---|---|
| A | 合規層① 升規子規則(純文字規則強化) | ✓ 採用(方案 C 組成一) |
| B | 查照格式插入「本次已讀文件清單」區塊(結構化格式) | ✓ 採用(方案 C 組成二) |
| A only | 僅規則,無格式 | 排除:規則是隱性的,不如格式顯眼,容易滑動 |
| B only | 僅格式,無規則說明 | 排除:缺少 WHY 說明,格式有可能被「形式填寫」而失去意義 |
選方案 C(A+B 並行)的理由
「已讀清單先行」把 IMP-111 的隱性要求轉成顯性格式:
- 結構化格式(B):讓 Tim 一眼看出「這次哪些文件有實際讀取、哪些沒有」
- 規則說明(A):解釋 WHY,讓 Claude 在未預見情境中能舉一反三
- 兩者互補:規則說明如何判斷,格式強制展示判斷依據
預期效果
以後每次查照都有可見的「本次已讀文件清單」區塊,Tim 批准查照時可以:
- 快速掃描清單,確認「必讀文件」欄位是否都有「✅ 已讀」
- 發現「⚠️ 未讀」項目時,立刻知道對應的查照結果欄應有【未驗假設】標注
- 不需要記憶哪些文件「應該被讀」,清單本身就是核對依據
執行記錄
| 修改 | 檔案 | 位置 |
|---|---|---|
| 新增合規層① 方案 C 子規則 | CLAUDE.md |
合規層 → 合規項目① → IMP-111 > 之後 |
| 新增「本次已讀文件清單」區塊 | CLAUDE.md |
查照格式模板 → 「查照結果」之前 |
| 建立本 RCF 文件 | knowledge/decisions/RCF-035-pre-read-list-format.md |
新建 |
| 文件索引新增條目 | knowledge/decisions/README.md |
末行新增 |
| 最近修改記錄更新 | knowledge/CLAUDE.md |
最近修改記錄表 |