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

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 行),主要透過「反應性規則新增」積累: 每次遇到一個壞輸出就新增一條規則,缺乏系統性清理機制。具體問題:

  1. Q2 衝突(最嚴重):兩段式啟動協議寫「第一段唯一允許動作:讀取 tasks.md」,但 IAUD 合規層① 同時要求第一段必須讀取 inventory.json + system-deep-review.md(作業模式必讀文件)才能輸出查照。這個矛盾在本次稽核的前一 session 被 Claude 親身遭遇。

  2. Q3 重複(最大體積問題):收尾七件事在主 CLAUDE.md + 16 個部門 CLAUDE.md 全部逐字複製,共 17 份。每次規則更新後 17 份都要同步,已知出現過同步遺漏問題。

  3. Q1/Q5 冗餘:「架構設計現況確認指南」(50 行獨立章節)是 IAUD 合規層① 的完整重複;「CEO 行為定義」散文段落(100 行)用散文描述已在其他部分有明確規則的行為。

  4. 「垃圾抽屜」章節:「核心原則:最新資訊優先」混入 12 個不同性質的子原則,其中 8 個(問答/即時更新/查照可見性/瀏覽器授權/待辦清單/有效利用/最小化人工/系統深度了解)是對 HARD STOP 規則的文字重複。

  5. 全系統拉取協議:~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 行)
精簡章節(精簡稿中已縮減) 全系統拉取協議(200→35 行表格);核心原則(150→50 行);角色定義(200→100 行)
觸發部門同步(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

驗證方式

  1. Q2 衝突是否解決:執行一次需要讀取 inventory.json 的查照(如盤點任務),確認 Claude 在第一段可以讀取作業模式必讀文件而不被「唯一允許動作」規則阻擋
  2. 精簡版完整性:在 Tim 審核精簡稿時,逐 HARD STOP 確認每條規則仍在精簡稿中、文字無縮水
  3. 行數減少:精簡稿行數應在 1,050-1,100 行之間(原 1,636 行的 35% 減量)
  4. 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
← 返回 決策記錄