如果你想讓 Claude Code 像一位常駐在你代碼庫裏的資深工程師，你的項目就必須要有結構。

Claude 在任何時候都需要四樣東西：

• 目標（Why）→ 系統是做什麼的

• 地圖（Map）→ 東西都在哪兒

• 規則（Rules）→ 允許/禁止什麼

• 工作流（Workflows）→ 事情如何完成

CLAUDE.md = 代碼庫記憶（保持簡短）這是你的北極星文件。不是知識堆砌，只需包含：

• 項目目標（WHY）

• 代碼庫地圖（WHAT）

• 規則與指令（HOW）

如果寫得太長，模型反而會忽略重要上下文

.claude/skills/ = 可複用的專家模式別再重複寫指令了。把常用工作流封裝成“技能”：

• 代碼審查清單

• 重構操作手冊

• 發佈流程

• 調試步驟

結果：跨對話、跨成員，都能保持一致性。

.claude/hooks/ = 防護欄模型會忘。

鈎子不會。用它們來處理必須確定的事情：

• 編輯後自動運行格式化

• 核心改動時運行測試

• 阻止訪問敏感目錄（如認證、計費、數據遷移）

docs/ = 漸進式上下文別把提示詞塞爆。 Claude 只需要知道“事實存放在哪裏”：

• 架構概述

• 架構決策記錄

• 運維操作手冊

為高風險模塊設置局部 CLAUDE.md 在關鍵位置放置小型指引文件：

src/auth/CLAUDE.md

src/persistence/CLAUDE.md

infra/CLAUDE.md

這樣，Claude 在處理這些模塊時，能立刻看到具體的注意事項。

總結

提示詞是暫時的，結構是永久的，當你的代碼庫按這種方式組織起來時，Claude 就不再表現得像一個聊天機器人，而開始像一個生於項目、長於項目的工程師。