RCF-045 — 部門 CLAUDE.md 收尾七件事指針化(Option B)
類型:規則變更 日期:2026-05-16 觸發條件:條件 2 — 批量同步 14 個部門 CLAUDE.md(收尾七件事區塊修改) 相關文件:
- 全部 14 個部門 CLAUDE.md(hr/dev/security/business/product/knowledge/crm/finance/content/legal/growth/edu/strategy/social)
CLAUDE.md(主文件)v2.3→v2.4CLAUDE-精簡版-draft.md(line 954 觸發條件更新)
問題背景
各部門 CLAUDE.md 的「收尾七件事」區塊直接複製了主 CLAUDE.md 的 8 行完整步驟清單。每次主文件修改收尾規則(步驟順序、措辭、新增子規則),就必須手動同步到全部 14 個部門文件,且容易漏同步或版本不一致(過去已發生「收尾六件事」vs「收尾七件事」記數不同步的 bug)。
此外,部門 CLAUDE.md 的 8 行步驟清單佔用大量 context 空間,且與主文件完全重複,沒有差異化資訊。
考慮過的方案
| 方案 | 描述 | 優點 | 缺點 | 採用? |
|---|---|---|---|---|
| 方案 A | 維持現狀,每次主文件修改後手動同步 14 個部門 | 每個部門檔案自給自足 | 同步成本高、版本不一致風險持續存在、重複 context 佔用 | ❌ 未採用 |
| 方案 B(最終採用) | 將 14 個部門的 8 行完整步驟替換為 3 行指針:「詳見總部 CLAUDE.md →「核心原則零:收尾七件事」」 | 消除重複、零版本不一致風險、主文件修改自動繼承、節省 context | 部門文件單獨讀取時需跳轉查閱 | ✅ 採用 |
| 方案 C | 將收尾七件事提取為獨立共用文件,各部門 import | 架構更乾淨 | 需建立新的引用機制,Claude 不支援 import 語法,複雜度高 | ❌ 未採用 |
最終決策
採用方案 B(指針化)。部門 CLAUDE.md 的收尾七件事只需知道「去哪裡查完整規則」,不需要複製規則本身。指針格式固定為 3 行:
## 收尾七件事(每次對話結束前必做)
收尾完整規則詳見**總部 CLAUDE.md →「核心原則零:收尾七件事」**(7 步驟:git push / 最近修改記錄 / tasks.md / inventory.json / daily-log / reflection-log / 品質自查 HARD STOP / 未完成清單 HARD STOP)。
**步驟 1 提醒**:「更新本文件最近修改記錄」= 更新本 CLAUDE.md 的「最近修改記錄」表格。
edu/strategy/social 因原格式為 **bold** 而非 ## heading,使用對應的 bold 版本。
步驟 1 提醒(更新本文件最近修改記錄)保留在各部門,因為這是部門特有資訊,不能靠主文件提供。
方案 A 被排除,原因是同步成本隨修改頻率累積,且「收尾六件事」vs「收尾七件事」計數 bug 已發生一次,顯示人工同步不可靠。
影響範圍
| 影響類型 | 具體項目 |
|---|---|
| 修改文件(14 個部門 CLAUDE.md) | 收尾七件事 8 行完整步驟 → 3 行指針(hr/dev/security/business/product/knowledge/crm/finance/content/legal/growth/edu/strategy/social) |
| 修改文件(主 CLAUDE.md) | ① bug 修正:「收尾六件事第 6 項」→「收尾七件事第 6 項」② 部門同步觸發條件更新(指針化後僅需修改主文件)③ 版本號 v2.3→v2.4 |
| 修改文件(CLAUDE-精簡版-draft.md) | line 954 觸發條件更新(同步反映指針化設計) |
| 新增文件 | knowledge/decisions/RCF-045-option-b-dept-claudemd-pointer.md(本文件) |
| 觸發部門同步 | 全部 14 個部門(本 RCF 的主題即為同步動作本身) |
| 影響的 SKILL | 無(收尾 SKILL 文件不受影響) |
驗證方式
- 讀取任一部門 CLAUDE.md → 確認收尾七件事區塊為 3 行指針格式(非 8 行完整步驟)
- 讀取主 CLAUDE.md → 確認「收尾七件事第 6 項」(非六件事)、部門同步觸發條件已反映指針化、版本號 v2.4
- 下次修改主 CLAUDE.md 收尾七件事時 → 確認僅需修改主文件,無需逐一 Edit 14 個部門文件