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

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 批准查照時可以:

  1. 快速掃描清單,確認「必讀文件」欄位是否都有「✅ 已讀」
  2. 發現「⚠️ 未讀」項目時,立刻知道對應的查照結果欄應有【未驗假設】標注
  3. 不需要記憶哪些文件「應該被讀」,清單本身就是核對依據

執行記錄

修改 檔案 位置
新增合規層① 方案 C 子規則 CLAUDE.md 合規層 → 合規項目① → IMP-111 > 之後
新增「本次已讀文件清單」區塊 CLAUDE.md 查照格式模板 → 「查照結果」之前
建立本 RCF 文件 knowledge/decisions/RCF-035-pre-read-list-format.md 新建
文件索引新增條目 knowledge/decisions/README.md 末行新增
最近修改記錄更新 knowledge/CLAUDE.md 最近修改記錄表
← 返回 決策記錄