RCF-046 — IAUD③ 升規 v2:SKILL 步驟引用外部文件格式強制讀取 + 「步驟將展示」≠ 展示原則
類型:規則變更 日期:2026-05-17 觸發條件:條件 1 — 修改 HARD STOP 規則(IAUD 合規層③,IMP-117 第 4 次出現升規) 相關文件:
CLAUDE.md(主文件 IAUD 合規層③ 修改)knowledge/improvements.md(IMP-117 狀態更新 ✅ 已升規 v2)
問題背景
IMP-117 自 2026-05-06 首次記錄,到 2026-05-17 已累積第 4 次出現,根本模式逐次精煉:
第 1-2 次(Session 130/133):查照比較表 preview 只有結構框架,格子內容空洞。 → RCF-038 升規 v1:IAUD③ 加入「表格/矩陣類每格必須有 ≥ 1 句實質描述」。
第 3 次(Session 13x):同類但範圍更廣,確認升規已成功限制表格案例。
第 4 次(2026-05-17,Session 15): /verify SKILL 設計查照,Step 3 寫:「讀 ga4-weekly-log.md 前 5 行,確認格式」。 問題:這是步驟承諾,不是展示。查照輸出時 ga4-weekly-log.md 根本未被讀取,格式確認也未發生。Tim 在第 4 輪才授權實際讀取。
根本模式抽象化: 「步驟 X 將展示 Y」≠「Y 已展示」。IAUD③ 的「展示」必須是查照輸出時已包含的實質內容,而非步驟承諾或未來計畫。此外,SKILL/步驟設計中引用「依 X 格式」「讀 X 前 N 行」等外部文件格式說明,本身就暗示需要知道格式才能描述——這意味著查照前必須已實際讀取該文件並展示節錄,否則步驟描述只是推測。
現有 IAUD③ 規則(RCF-038 版本):
涉及新建/修改的文件,已在查照中展示核心內容(N 文件變更 → N 個預覽區塊);表格/矩陣類每格必須有 ≥ 1 句實質描述
這只約束了「文件建立/修改」的 preview,沒有約束「步驟設計中引用外部文件格式」和「承諾展示 ≠ 已展示」兩種新型態缺口。
考慮過的方案
| 方案 | 描述 | 優點 | 缺點 | 採用? |
|---|---|---|---|---|
| 方案 A | 只加「步驟承諾 ≠ 展示」原則,不觸及外部文件讀取規則 | 輕量,只解決第 4 次具體問題 | 未覆蓋 SKILL 引用外部格式的普遍情況;下次仍可能只寫「依 X 格式」而不讀 | ❌ 未採用 |
| 方案 B | 只要求所有 SKILL 步驟中提到的文件都在查照前讀取 | 完整消除「引用未讀文件」 | 過於嚴格,某些步驟只是過場說明,不需要讀取才能描述 | ❌ 未採用 |
| 方案 C(最終採用) | 雙子規則:① 引用外部文件「格式」說明(「依 X 格式」「讀 X 前 N 行」)→ 查照前必須實際讀取並展示格式節錄;② 「步驟 X 將展示 Y」≠ 展示,IAUD③ 要求的展示必須是已包含於查照輸出的實質內容 | 精準覆蓋兩種具體缺口,不過度擴展到所有文件 | 需要 Claude 判斷「引用格式說明」的邊界(有一定模糊度) | ✅ 採用 |
最終決策
採用方案 C,在 IAUD 合規層③ 末尾附加兩個子規則:
新增文字(追加於③ 現有規則後):
;SKILL/步驟設計中引用外部文件格式(「依 X 格式」「讀 X 前 N 行」)→ 查照前必須實際讀取並展示格式節錄;**「步驟 X 將展示 Y」≠ 展示**(IMP-117 × 4)
選擇理由:
- 方案 A 無法解決 SKILL 設計中「引用外部格式但未讀取」的普遍模式(下次仍可能發生)
- 方案 B 過於嚴格,「所有 SKILL 步驟中提到的文件都必須讀取」會造成不必要的開銷
- 方案 C 的邊界判斷準則明確:涉及「格式節錄」描述(前 N 行、格式說明、欄位結構)→ 必須已讀;只是路徑引用或說明用途 → 不強制
影響範圍
| 影響類型 | 具體項目 |
|---|---|
| 修改文件 | CLAUDE.md — IAUD 合規層③(Line 185 附近)新增兩個子規則 |
| 修改文件 | knowledge/improvements.md — IMP-117 出現次數 3→4、狀態更新為 ✅ 已升規 v2 |
| 不觸及 | 部門 CLAUDE.md(收尾七件事已指針化;合規層③ 規則繼承自主文件,無需逐一 Edit) |
| 影響的 SKILL | 所有包含外部文件格式引用的 SKILL 查照(如 /verify SKILL 設計時的 Step 3 類型步驟) |
驗證方式
下次執行任何 SKILL 設計查照,若步驟中寫到「讀 X 前 N 行」或「依 X 格式輸出」:
- 查照輸出前必須先讀取該文件
- 查照中必須展示該文件的格式節錄(而非空洞承諾)
- 若查照中出現「步驟 X 將展示 Y」→ 立即補完實際展示,不允許只留承諾