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

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.4
  • CLAUDE-精簡版-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 文件不受影響)

驗證方式

  1. 讀取任一部門 CLAUDE.md → 確認收尾七件事區塊為 3 行指針格式(非 8 行完整步驟)
  2. 讀取主 CLAUDE.md → 確認「收尾七件事第 6 項」(非六件事)、部門同步觸發條件已反映指針化、版本號 v2.4
  3. 下次修改主 CLAUDE.md 收尾七件事時 → 確認僅需修改主文件,無需逐一 Edit 14 個部門文件
← 返回 決策記錄