CLAUDE CODE · 通用架構指南
v2.0 / 2026.05
寫給沒寫過程式的人

把 AI
變成一個會分工的團隊

不用學程式,只要學會「怎麼分配工作」,
就能讓 Claude Code 自己幫你把事情做完。

適用   Mac · Windows
時長   約 12 分鐘
章節   共 6 個段落
製作   Nelson
01 — 一個比喻
02 / 22
想像一下

你今天開了一間公司
只是員工全部都是 AI。

這套架構,就是公司的規章、人事、SOP
寫好一次,往後 AI 就會照著它自動幫你工作。

01 — 一個比喻
03 / 22
為什麼需要這套架構

一個 AI 什麼都做,
一個團隊各司其職,差很多。

沒有架構

什麼都丟給同一個 AI

每次都要重新解釋背景、口味、規則。久了它會忘記、會走鐘、會做出你不要的東西。

有架構

讓 AI 自己組隊接力

你只說「我想做什麼」,產品 AI 整理需求、開發 AI 動手、測試 AI 把關 — 全程自動。

02 — 六大元件
04 / 22
章節二

這套架構由六個元件組成。
把它們對照成一間公司,馬上就懂。

02 — 六大元件
05 / 22

把 AI 的工作環境,看成一間公司

01
公司規章

Rules
規則

AI 絕對不能違反的紅線。
例:「不准刪資料庫」。

02
員工名冊

Agents
角色

每位 AI 的職責和個性說明,
誰負責什麼、用什麼口氣。

03
培訓手冊

Skills
技能包

讓 AI 瞬間變專家。
例:SEO、影片剪輯、寫合約。

04
快捷鍵

Commands
指令

一句話啟動整套流程。
例:/team-full

05
品管站

Hooks
自動檢查

AI 做完事自動掃描,
有問題擋下來、提醒你。

06
App Store

Plugins
插件

別人做好的整套團隊,
一行指令直接裝起來。

02 — 六大元件 · CLAUDE.md
06 / 22
核心配置

CLAUDE.md
AI 的總指令書

這是 AI 每次開工前
第一個讀的檔案。
你的偏好、風格、底線,
全部寫在這裡。

小提醒:寫太長 AI 反而會忽略重點,保持精簡。

# 優先順序(高→低) 1. ~/.claude/CLAUDE.md ← 個人偏好(只有你看到) 2. 專案/.claude/CLAUDE.md ← 團隊共用(版本控制) 3. 子資料夾/CLAUDE.md ← 特定區域的補充說明

@rules/security.md 語法引用其他檔案,保持模組化。

02 — 六大元件 · 01 Rules
07 / 22
01 規則 Rules

公司規章

寫下 AI 永遠要遵守的紅線。
每次它做事之前,都會先翻一遍。

不准動正式資料庫 永遠用繁體中文 寫完要附測試
# tech-stack.md 前端 使用 React + Tailwind 後端 使用 Node.js + Postgres 禁止 自己安裝任何新套件 # security.md 不可 直接修改正式資料庫 不可 把金鑰寫進程式碼
02 — 六大元件 · 02 Agents
08 / 22
02 角色 Agents

員工名冊

每位 AI 角色,
都是一個 .md 檔案。
裡面寫著他的身份、口氣、能做什麼、不能做什麼。

LEADER
技術主管
產品組
產品經理
需求分析師
設計師
開發組
架構師
後端工程師
前端工程師
品質組
測試規劃
測試執行
02 — 六大元件 · 03 Skills
09 / 22
03 技能包 Skills

培訓手冊

AI 平常是通才。
碰到特定任務時,
就翻出對應的技能包,
立刻變專家。

官方商店 · 社群商店 · 自己寫,三種來源。

.claude/skills/seo-optimization/ └── SKILL.md --- name: seo-optimization description: SEO 優化指南 --- # 關鍵字策略 - 每頁聚焦一個主關鍵字 - 標題要包含關鍵字 - ...
02 — 六大元件 · 05 Plugins
10 / 22
05 插件 Plugins

App Store

別人做好的整套工具組合,
一行指令就能裝起來。
包含技能包、工具、設定,
一次到位。

# 安裝官方插件 claude /plugin install skills@anthropics # 安裝社群插件 claude /plugin install name@community # 從 GitHub 安裝 claude /plugin install owner/repo

Plugins 插件

像一個 App —
包含技能包 + 工具 + 設定

Skills 技能包

像一本手冊 —
只有知識和指導方針

02 — 六大元件 · 04 Hooks
11 / 22
04 自動檢查 Hooks

AI 做完事,自動有人來把關

事前 · PreToolUse

動手前先攔住

AI 準備執行某個動作之前先檢查一次。
例:要刪資料庫,直接擋下。

事後 · PostToolUse

做完後自動掃描

AI 寫完程式之後再檢查一次。
例:有沒有把密碼意外寫進程式碼。

BLOCK · 嚴重,先修
WARNING · 完成前記得修
INFO · 純提醒
03 — 動手做
12 / 22
章節三

理論說夠了。
真的動手做,只要兩件事。

第一:在電腦裝好 Claude Code。
第二:把 .claude/ 資料夾建出來。

03 — 動手做
13 / 22

安裝就一行指令

兩個平台、同一行字。貼上、Enter、完成。

Mac
curl -fsSL https://code.claude.com/install | sh

打開「終端機」貼上即可。
先裝 Node: brew install node

Windows
curl -fsSL https://code.claude.com/install | sh

打開 PowerShell 貼上即可。
先裝: Git for Windows · Node.js

完成後 在任何地方輸入 claude 就會開始跟它對話。
03 — 動手做
14 / 22
外部工具串接

MCP
連接外部世界

讓 AI 連上你的工具 —
GitHub、資料庫、Slack...
透過一個設定檔搞定。

團隊共用
.mcp.json
個人專用
~/.claude.json
// .mcp.json { "mcpServers": { "github": { "command": "npx", "args": ["-y", "@mcp/server-github"], "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" } } } } // ${...} = 讀取環境變數 // 密鑰不會寫進檔案裡
03 — 動手做
15 / 22
資料夾結構

一個資料夾,
就是你的 AI 部門。

六種元件,
各自放在六個子資料夾裡。
清楚、好找、可以分享給別人。

個人專用
~/.claude/
團隊共用
專案/.claude/
Windows 路徑
C:\Users\你\.claude\
.claude/ ├── rules/ 公司規章 │ ├── tech-stack.md │ ├── security.md │ └── workflow.md ├── agents/ 員工名冊 │ ├── ALL-TEAM.md │ ├── product-team.md │ └── dev-team.md ├── skills/ 培訓手冊 │ └── seo/SKILL.md ├── commands/ 快捷指令 │ └── team-full.md └── hooks/ 品管站
03 — 動手做
16 / 22
標準工作流程

完成一個功能,五個步驟

STEP 01
定義專案
我們要做什麼?
給誰用?
STEP 02
釐清需求
把模糊的想法
變成清楚的規格。
STEP 04
動手開發
寫後端、
做前端。
STEP 05
測試上線
跑測試、
審查、驗收。
04 — 應用場景
17 / 22
不只能寫程式

同樣一套架構,
能拿來做任何有 SOP 的事

舉例:一條短影音自動產線。

STEP 01
選題策略師
分析哪些主題會紅。
STEP 02
編劇
寫口播稿和字幕。
STEP 03
視覺導演
每段畫面怎麼拍。
STEP 04
自動化工程師
生成影片並發布。
STEP 05
數據分析師
看成效、回饋選題。
一鍵啟動 /create-short-video 我的產品是減脂代餐
04 — 應用場景
18 / 22
更多場景

只要有步驟和規則
都能交給 AI 團隊。

01

客服自動化

AI 客服回覆客戶問題,
遇到複雜情況自動轉人工,
附上完整摘要。

02

文件審查

自動檢查合約、報告、
提案有沒有遺漏或矛盾,
標出需要注意的地方。

03

數據報表

自動抓取數據、
生成圖表和分析報告,
每天 / 每週定時產出。

05 — 一句話啟動
19 / 22
最後一塊拼圖

把這段話
貼給 Claude

所有元件就會被啟動,
AI 團隊正式上線。

我正在開始一個新的 [專案類型] 專案。

1.你是技術主管兼架構師。
2.請先讀 rules/ 裡的所有規定。
3.請看 agents/ALL-TEAM.md 了解你的隊友。
4.我提需求時,先想清楚資料怎麼存,
    再開始寫程式。

請確認你已了解整套工作流程。
06 — 資源
20 / 22

想再深入?這些可以收藏

全部都是官方或社群維護的資源。

資源 網址 用途
使用教學docs.anthropic.com/en/docs/claude-code從零開始學
官方最佳實踐anthropic.com/engineering/claude-code-best-practices官方推薦用法
技能包標準agentskills.io跨平台通用規範
官方技能商店github.com/anthropics/skills下載官方技能包
官方精選插件github.com/anthropics/claude-plugins-official經過審核的插件
AI 模板庫aitmpl.com現成的角色與技能包
06 — 資源
21 / 22

常見問題

CLAUDE.md 要寫多長?

越精簡越好。如果拿掉某一行 AI 也不會出錯,那就刪掉。寫太長反而會讓 AI 搞不清楚重點。

Rules 和 Skills 差在哪?

Rules 是永遠生效的底線(例:不准洩漏密碼)。Skills 是需要時才叫出來的專業知識(例:怎麼做 SEO)。

Windows 用哪種安裝方式?

大部分人直接裝在 Windows 上就夠了。如果你需要跑 Docker 或 Linux 指令,再選 WSL。

怎麼跟團隊共用設定?

專案裡的 .claude/ 加入版本控制(Git),團隊所有人共用同一套。個人的 ~/.claude/ 不要加。

END
22 / 22
開始你的第一步

今天,
.claude/ 建出來

Step 1
安裝 Claude Code
Step 2
建 .claude/ 資料夾
Step 3
貼上啟動 Prompt

就這麼簡單。