Claude Code 專案結構

系統化建置 Claude Code 專案的標準目錄。避免一來就直接打 prompt——好的目錄結構讓 AI 協作更可控。

標準目錄（2026 完整版）

project-root/
├── CLAUDE.md             ← 核心指南（必要、進 git）
├── CLAUDE.local.md       ← 本地專屬規則（gitignored）
├── .mcp.json             ← 專案 MCP servers
├── .worktreeinclude      ← git worktree 範圍（NEW 2026）
└── .claude/              ← control center
    ├── settings.json     ← 權限、hooks、env
    ├── settings.local.json ← 本地覆寫
    ├── rules/            ← 模組化規範（條件觸發）
    ├── commands/         ← Slash commands
    ├── skills/<name>/SKILL.md  ← 智慧情境觸發
    ├── output-styles/    ← 輸出風格定義（NEW 2026）
    ├── agents/           ← Subagent personas
    └── agent-memory/<name>/ ← agent 跨 session 記憶（NEW 2026）

詳細解構見 Anatomy of .claude。

各目錄職責

1. CLAUDE.md（核心指南）

詳見 CLAUDE.md（專案手冊）。專案背景、Coding Standards、注意事項——Claude 每次啟動先讀。

等同團隊新人的 Onboarding 文件。

2. rules/（模組化規範）

當 CLAUDE.md 變多時拆解到 rules/：

• coding-style.md — 程式風格
• testing.md — 測試規範
• security.md — 資安要求
• naming.md — 命名規範

各司其職，後續維護方便。

3. commands/（流程自動化）

重複性流程定義成指令：

• 「跑一遍 Lint 檢查後發 PR」
• 「產生 Changelog」
• 「跑測試後 deploy」

之後一句話就能調用，不必每次重新描述步驟。對應 Slash Commands 概念。

4. skills/（智慧情境觸發）

按上下文自動觸發的邏輯。

例：當打開特定類型檔案時自動執行檢查——不需手動下令，Claude 根據情境自行判斷。

對應 SKILL.md 規範。

5. agents/（獨立任務專家）

需獨立運行的子代理。彼此隔離、各解各的任務，不會互相污染 Context。

對應 Sub-agent。

6. settings.json（權限管控）

哪些操作：

• ✅ 允許執行
• ⚠️ 需人工確認
• ❌ 嚴格禁止

白紙黑字寫清楚，確保安全性。

兩層級的 .claude/

層級	位置	範圍
Project Level	專案根 .claude/	隨 Repo Commit，團隊共享
Global Level	~/.claude/	個人偏好，只屬於你

實作建議：

• 團隊共用約定 → Project Level（會 git commit）
• 個人偏好（如語言、輸出格式） → Global Level（不影響他人）

心智模型：每個資料夾 = 行為的一個維度

資料夾	對應行為	Vincent 的話
rules/	what Claude knows	知識 / 紅線
skills/	how it works	方法 / SOP
agent-memory/	what it remembers	記憶
commands/	what it does	動作 / 指令
agents/	who it becomes	人格 / 角色
output-styles/	how it communicates	風格

→ 設計新模組時對著這 6 維度問「我要影響哪個維度？」就找到該放哪。

「實際載入了什麼」用這些 slash commands 查

指令	看什麼
/context	各類別 token 用量
/memory	CLAUDE.md + rules 載入內容
/agents	已配置的 subagent
/hooks	啟用的 hooks
/mcp	連線的 MCP servers
/skills	可用的 skills
/permissions	allow / deny 規則
/doctor	完整診斷

對 PAM 的應用

PAM 專案目前只有根目錄 CLAUDE.md（38KB），未來可拆：

ExamSystem/
├── CLAUDE.md                    ← 高層架構
└── .claude/
    ├── rules/
    │   ├── ef-core-style.md     ← EF Core 慣例
    │   ├── controller-style.md  ← Controller 規範
    │   └── pdf-generation.md    ← PDF 套表規範
    ├── commands/
    │   ├── recalc-scores.md     ← 重算分數流程
    │   └── sync-104.md          ← 104 同步流程
    ├── skills/
    │   ├── pam-grade-checker/   ← 等第檢查 skill
    │   └── pam-spec-lookup/     ← 規格速查 skill
    └── agents/
        └── pam-reviewer/        ← 程式碼 reviewer agent

當 CLAUDE - 主開發規格 持續成長時，是該考慮拆檔的時機。

相關概念

強連結（原文明確提及）

• Anatomy of .claude — 2026 完整版視覺圖解
• Claude Code — 用 Claude Code 落地此結構
• CLAUDE.md（專案手冊） — 核心指南
• CLAUDE.md 4 層機制 — 4 層疊加生效
• Rules Directory — rules/ 詳細規格
• Slash Commands — commands/ 觸發
• SKILL.md 規範 — skills/ 機制
• Sub-agent — agents/ 機制
• Hooks — 配合 commands 自動化
• 反面案例提示 — CLAUDE.md 寫法技巧

深入閱讀（外部資源）

• 深入閱讀：09-Claude Code 建置與使用

← 回到 wiki