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

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 格式輸出」:

  1. 查照輸出前必須先讀取該文件
  2. 查照中必須展示該文件的格式節錄(而非空洞承諾)
  3. 若查照中出現「步驟 X 將展示 Y」→ 立即補完實際展示,不允許只留承諾
← 返回 決策記錄