RCF-044 — CLAUDE.md 全面稽核精簡:五問框架稽核 + Q2 衝突修正 + 精簡版草稿
類型:規則變更 日期:2026-05-16 觸發條件:條件 1 — 修改 HARD STOP 規則(兩段式啟動協議「唯一允許動作」矛盾修正) 相關文件:
CLAUDE.md(主文件,1,636 行)CLAUDE-精簡版-draft.md(精簡稿,~1,063 行,待 Tim 審核後替換主文件)- 16 個部門
*/CLAUDE.md(收尾七件事段落,Option A/B 待決定)
問題背景
CLAUDE.md 從 v1.0 成長至 v2.3(1,636 行),主要透過「反應性規則新增」積累: 每次遇到一個壞輸出就新增一條規則,缺乏系統性清理機制。具體問題:
Q2 衝突(最嚴重):兩段式啟動協議寫「第一段唯一允許動作:讀取 tasks.md」,但 IAUD 合規層① 同時要求第一段必須讀取 inventory.json + system-deep-review.md(作業模式必讀文件)才能輸出查照。這個矛盾在本次稽核的前一 session 被 Claude 親身遭遇。
Q3 重複(最大體積問題):收尾七件事在主 CLAUDE.md + 16 個部門 CLAUDE.md 全部逐字複製,共 17 份。每次規則更新後 17 份都要同步,已知出現過同步遺漏問題。
Q1/Q5 冗餘:「架構設計現況確認指南」(
50 行獨立章節)是 IAUD 合規層① 的完整重複;「CEO 行為定義」散文段落(100 行)用散文描述已在其他部分有明確規則的行為。「垃圾抽屜」章節:「核心原則:最新資訊優先」混入 12 個不同性質的子原則,其中 8 個(問答/即時更新/查照可見性/瀏覽器授權/待辦清單/有效利用/最小化人工/系統深度了解)是對 HARD STOP 規則的文字重複。
全系統拉取協議:~200 行散文描述,但資訊密度低,可轉換為 23 行的部門/檔案表格而不損失任何資訊。
考慮過的方案
| 方案 | 描述 | 優點 | 缺點 | 採用? |
|---|---|---|---|---|
| 方案 A(維持現狀) | 只修正已知 Q2 衝突,其他不動 | 風險低,改動最小 | 原始問題持續,每次對話載入 1,636 行冗餘 | ❌ 未採用 |
| 方案 B(全面精簡) | 五問框架稽核 29 章 → 精簡版草稿 → Tim 審核後替換 | 35% 減量(1,636→~1,063 行),保留所有 HARD STOP,修正衝突 | 一次改動較大,Tim 審核成本 | ✅ 採用 |
| 方案 C(移至 CLAUDE-detail.md) | 把刪除項目移入 CLAUDE-detail.md | 保留資訊 | 發現 CLAUDE-detail.md 是前車之鑑格式(event/root-cause/rule-reference),不適合承接規則文字 | ❌ 排除(查照階段發現) |
部門 CLAUDE.md 的收尾七件事:Option A vs Option B
| 選項 | 描述 | 優點 | 缺點 |
|---|---|---|---|
| Option A(維持) | 16 個部門 CLAUDE.md 繼續保留逐字副本 | 每個部門文件自給自足,不需跨檔查詢 | 17 份同步問題持續存在,每次升規須逐一 Edit |
| Option B(指針) | 16 個部門 CLAUDE.md 的收尾七件事改為單行指針「→ 主 CLAUDE.md 收尾七件事(Step 0-7)」 | 節省 ~1,120 行(16 × ~70 行),升規只需改主文件 | 部門文件需查主文件;若新人只讀部門 CLAUDE.md 可能漏掉步驟 |
⚠️ Tim 尚未決定 Option A/B,此 RCF 記錄兩選項,執行後補記。
最終決策
已執行:Q2 衝突修正
問題:「唯一允許動作:讀取 tasks.md,然後輸出查照格式。除此之外,不呼叫任何工具」← 這句話讓 IAUD 合規層① 的必讀文件(inventory.json、system-deep-review.md)無法在第一段讀取,形成結構性矛盾。
修正文字(寫入精簡版草稿):
第一步讀取 dev/tasks.md,再讀取作業模式必讀文件,然後輸出查照格式。
除此之外,不呼叫任何工具、不建立任何檔案、不執行任何動作。
WHY 選此方案:原文「唯一允許動作」是設計用來防止 Claude 在第一段就開始「幫忙做事」,核心意圖是「不建立檔案/不執行操作」,而不是「不允許讀取必讀文件」。修正後的文字保留了原意,同時與 IAUD 合規層① 相容。
已執行:精簡版草稿建立(待 Tim 審核)
29 章五問稽核完成,精簡版草稿寫入 CLAUDE-精簡版-draft.md:
- 刪除 19 項(~330 行)
- 精簡 10 項(~243 行)
- 總節省估計
573 行(35%,1,636→1,063) - 所有 HARD STOP 規則:完整保留,無刪減
影響範圍
| 影響類型 | 具體項目 |
|---|---|
| 新增文件 | CLAUDE-精簡版-draft.md(精簡稿,待審核後替換主文件) |
| 修改文件(待執行) | CLAUDE.md(主文件,Tim 審核後以精簡稿替換) |
| Q2 衝突修正 | 兩段式啟動協議「唯一允許動作」措辭 |
| 刪除章節(精簡稿中已刪) | 架構設計現況確認指南(完整章節,~50 行) |
| 精簡章節(精簡稿中已縮減) | 全系統拉取協議( |
| 觸發部門同步(Option B 執行後) | 16 個部門 */CLAUDE.md 的收尾七件事段落(改為單行指針) |
精簡版主要刪除清單(19 項,~330 行)
| # | 刪除項目 | 原因 | 估計行數 |
|---|---|---|---|
| 1 | 快速索引→常用章節速查 表格 | Q1:Claude 靠名稱就能找到章節,不需要這個表 | 15 |
| 2 | 上下文壓縮接續→主動壓縮提醒子節 | Q1:Claude 已會執行,無需提醒規則 | 20 |
| 3 | 兩段式協議→Tim 的攔截機制子節 | Q3:與第一段查照流程描述重複 | 15 |
| 4 | 架構設計現況確認指南(完整章節) | Q2+Q3:IAUD 合規層① 的完整重複 | 50 |
| 5 | CEO 行為定義→任務判斷輸出格式框 | Q5:「任務類型/分配部門/完成標準」格式實務從未使用 | 15 |
| 6 | CEO 行為定義→釐清機制子節 | Q1:基本對話邏輯,不需列為規則 | 20 |
| 7 | CEO 行為定義→主動性子節 | Q3:與策略模式/CEO 定義重複 | 15 |
| 8 | 核心原則→問答原則子節 | Q3:與釐清機制/角色定義重複 | 20 |
| 9 | 核心原則→詳實設計原則子節 | Q1:無意識遵守,不是規則 | 15 |
| 10 | 核心原則→查照執行計畫可見性指引 | Q3:與 IAUD 合規層③ 完整重複 | 20 |
| 11 | 核心原則→瀏覽器操作授權原則 | Q3:HARD STOP 章節已有完整定義 | 15 |
| 12 | 核心原則→待辦清單嚴格確認原則 | Q3:兩段式協議已涵蓋,且是基本前提 | 10 |
| 13 | 核心原則→最小化人工操作原則 | Q3:與瀏覽器操作 HARD STOP 重複 | 20 |
| 14 | 核心原則→有效利用與完整化現有系統 | Q1:策略判斷,不是執行規則 | 15 |
| 15 | 核心原則→系統深度了解原則 | Q1:分析/開發模式已涵蓋 | 10 |
| 16 | 核心原則→即時更新原則 | Q3:系統狀態異動 HARD STOP 完整涵蓋 | 10 |
| 17 | SKILL 品質標準 5 條 | Q1:作者時間指引,Claude 執行 SKILL 時不需要 | 20 |
| 18 | 總管角色→分析框架輸出格式 | Q3:與 總管.md SKILL 重複 | 15 |
| 19 | 成本評估原則子節 | Q1:免費優先是常識,無需成文規則 | 15 |
驗證方式
- Q2 衝突是否解決:執行一次需要讀取 inventory.json 的查照(如盤點任務),確認 Claude 在第一段可以讀取作業模式必讀文件而不被「唯一允許動作」規則阻擋
- 精簡版完整性:在 Tim 審核精簡稿時,逐 HARD STOP 確認每條規則仍在精簡稿中、文字無縮水
- 行數減少:精簡稿行數應在 1,050-1,100 行之間(原 1,636 行的 35% 減量)
- Option B 效果(若執行):從任一部門 CLAUDE.md 讀取,收尾七件事段落為單行指針,不再是逐字副本
補記欄位(執行後填入)
- Tim 審核精簡版草稿:2026-05-16(Tim approve,補完版查照通過 IMP-111 gap 修正)
- 以精簡稿替換 CLAUDE.md:2026-05-16(cp 完成,header 已更新 v2.4-draft → v2.4)
- Option A / Option B:Tim 決定選 B(2026-05-16,上下文壓縮接續後第一件事)
- 14 個部門 CLAUDE.md 同步(Option B 執行):2026-05-16(8 行完整步驟 → 3 行指針,含步驟 1 提醒;詳見 RCF-045)
- git push 完成:2026-05-16