如何管理你的Claude 開發專案

避免一來就直接輸入Prompt,對於一個想正式執行的專案,我們可以更系統化的從目錄開始整理搭建
1. 核心指南:CLAUDE.md
第一步是撰寫 CLAUDE.md。
這是你給 Claude 的行動準則——包含專案背景、Coding Standards、注意事項等,通通寫在這裡。Claude 每次啟動都會先讀取它,功能等同於開發團隊的 Onboarding文件。
2. 模組化規範:rules/ 目錄
當內容變多時,就進行拆解。將規則按主題拆分到 rules/ 目錄下,例如:Coding Style一份、測試規範一份、資安要求一份。各司其職,後續維護才方便。
3. 流程自動化:commands/
將常用流程放在 commands/。
例如:「跑一遍 Lint 檢查後發 PR」、「產生 Changelog」這類重複性操作,直接定義成指令。之後一句話就能調用,不必每次都重新描述步驟。
4. 智慧情境觸發:skills/
按上下文自動觸發的邏輯放在 skills/。
例如:當打開特定類型的檔案時自動執行檢查。這不需要你手動下令,Claude 會根據情境自行判斷是否需要執行。
5. 獨立任務專家:agents/
需要獨立運行的子代理放在 agents/。
它們彼此隔離、各解各的任務,不會互相污染 Context。
6. 權限管控:settings.json
權限部分在 settings.json 裡直接鎖死。
哪些操作允許執行、哪些需要人工確認、哪些嚴格禁止,白紙黑字寫清楚,確保安全性。
補充:
.claude/ 其實分為兩個層級:
1. 專案層級(Project Level): 位於專案根目錄,會隨著程式碼倉庫(Repo)一起提交(Commit),由團隊全員共享。
2. 全域層級(Global Level): 位於 ~/.claude/(使用者目錄),儲存你的個人偏好與跨專案的自動記憶。這部分只屬於你,不會影響到別人。
實際使用上,也會發現:
1. 「反面案例」更有效
在 CLAUDE.md 裡寫反面案例比正面規範更有感。
例如:寫「不要將測試資料Hard Coding」會比寫「請使用 Fixture 管理測試資料」更能降低 Claude 的出錯率。讓 AI 知道「什麼不能做」比「該怎麼做」更精確。
2. 跟Claude說明為什麼:
與其單純告訴 Claude「使用 TypeScript」,不如說明「因為團隊全端統一使用 TS,所以不要引入 Python 」。帶有Context的指令,能讓 Claude 在遇到Edge Cases時,具備自行判斷的能力。
以上補充也可以Callback到之前整理的: Claude Code原始碼洩漏後,整理原始碼得到的好用prompt技巧,個人感覺真的很實用哦!