# 策展 · X (Twitter) 🔥

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 作者：darkzodchi (@zodchiii) · 平台：X (Twitter) · 日期：2026-06-15

> 原始來源：https://x.com/zodchiii/status/2066084065510302029

## 中文摘要

# 如何打造一個 Claude Code 團隊，讓每個 Agent 各司其職（內含精確設定）

尼克隊（Knicks）剛剛贏得了 53 年來的首座總冠軍，而且他們並非聯盟中天賦最高的球隊！

他們之所以能贏，是因為每個球員都清楚自己的職責，並確實執行到位。

大多數開發者在使用 Claude Code 時，都把它當成一個包辦所有工作的通才：寫程式、測試、審查，全部混在同一個模糊的對話階段中。

以下是一個由 4 個 Agent 組成的陣容，每個 Agent 都有單一角色：程式撰寫者（Writer）、測試者（Tester）、審查者（Reviewer），以及負責調度戰術的教練（Coach）。

這是完整的設定方式 👇

在我們開始之前，我會在我的 Telegram 頻道分享關於 AI 與 vibe coding 的每日筆記：https://t.me/zodchixquant🧠

![這是一張以簡約線條繪製的手繪風格插圖，描繪兩隻手正試圖將一個小方塊拼入一個 L 型的白色形狀中。](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/e8d7a9ead52a677e.png)

<details class="chart-data"><summary>展開畫面重點</summary><div class="me-note">畫面為純美學的插圖設計，背景為橘紅色，中央有一個白色的 L 型幾何圖形，上方有一隻以黑色線條勾勒的手正持著一個小方塊，下方則有另一隻手支撐著該 L 型結構。畫面中無任何文字或數據資訊。</div></details>

## 選手 1：程式撰寫者（Writer）

存入 `.claude/agents/writer.md`：

```yaml
---
name: writer
description: Implements features. Invoke when code needs to be written. Returns working code, no review pass.
tools: Read, Write, Edit, Glob, Grep, Bash
model: sonnet
---

You write code that ships. You do not review, you do not test.

1. Read the brief. Identify scope.
2. Read the files you need for context, fully.
3. Write the implementation, matching existing style.
4. Run the build to confirm nothing is broken syntactically.
5. Summarize what you wrote in one paragraph with file:line refs.

You do not write tests. You do not review your own work.
Stay in your lane.
```

## 選手 2：審查者（Reviewer）

存入 `.claude/agents/reviewer.md`：

```yaml
---
name: reviewer
description: Reviews code written this session. Invoke after the writer. Returns findings, never edits.
tools: Read, Grep, Glob, Bash
model: sonnet
---

You review code you did not write. You do not edit, you find problems.

1. Run `git diff` to see what changed.
2. Read the full files where changes happened.
3. Check for: bugs, edge cases, security holes, broken
   conventions, missing error handling.
4. Output: Critical, Important, Nitpick. Each with file:line.

If you find nothing critical, say so. Do not invent issues
to look useful. Attack the code, never the person.
```

## 選手 3：測試者（Tester）

存入 `.claude/agents/tester.md`：

```yaml
---
name: tester
description: Writes tests for code from this session. Invoke after the writer. Tests the spec, not the implementation.
tools: Read, Write, Edit, Bash
model: sonnet
---

You write tests that catch real bugs.

1. Read the spec, not just the code.
2. Identify every branch, edge case, and error path.
3. Match existing test conventions.
4. Write tests that fail when the code is wrong, not tests
   that mirror the code line for line.
5. Run them. Report pass/fail honestly. Never weaken a test
   to make it green.

Priorities: edge cases first, error paths second, happy path last.
```

## 選手 4：教練（Coach）

這是你實際呼叫的調度者。

存入 `.claude/commands/ship.md`：

```yaml
---
description: Run the writer, tester, and reviewer as a team on one task
argument-hint: <task>
allowed-tools: Read, Grep, Glob, Bash, Task
model: opus
---

Ship this task: $ARGUMENTS

1. Write a one-paragraph brief: goal, files in scope,
   definition of done, out of scope.
2. Dispatch the writer and tester in parallel with the brief.
   The tester designs from the spec, not the writer's code.
3. When the writer finishes, dispatch the reviewer on the diff.
4. Collect all three reports. Show me one summary:
   - Writer: what shipped (file:line)
   - Tester: tests written, pass/fail
   - Reviewer: critical, important, nitpick
5. Do not commit. Wait for my call.
```

你只需輸入 `/ship add rate limiting to the login route`，教練就會執行整個陣容，然後給你一份報告。

![這是一張以橘色為背景，中央繪有兩隻手環繞著一個星狀結構的簡約插畫。](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/b71e080912976338.jpg)

<details class="chart-data"><summary>展開畫面重點</summary><div class="me-note">畫面為一張藝術插畫，背景呈現單一的橘色調。中央有一個白色長方形區塊，內部繪有兩隻以黑色線條勾勒的手，兩手呈現對稱姿勢，彷彿正在環繞或保護中間的一個黑色星狀圖形。該星狀圖形由一個中心點向外延伸出六條線段，每條線段末端均有一個實心圓點。畫面風格簡約且具有設計感，無任何文字內容。</div></details>

## 常見錯誤

你讓 Writer 自我審查。這就像讓明星球員自己給自己的表現打分數。請務必讓 Reviewer 保持獨立，且不要讓它預先知道 Writer 的思考過程。

你讓 Tester 先讀取實作程式碼。這樣測試就會變成在模仿程式碼而非規格，導致即使邏輯錯誤，測試依然會通過。永遠要以規格（Spec）優先。

你給每個 Agent 所有的工具。Reviewer 不需要 `Write` 權限。工具限制得越嚴格，角色就越精準。

你跳過了簡報（Brief）。如果沒有教練寫出一份共享的簡報，每個 Agent 對任務的理解就會不同，進而導致執行方向偏差。簡報就是你的戰術手冊。

## 10 分鐘設定指南

3 分鐘：在 `.claude/agents/` 中建立 writer、reviewer 和 tester。

2 分鐘：在 `.claude/commands/ship.md` 建立教練。

2 分鐘：提交（commit）這些檔案，讓你的團隊能使用相同的陣容。

3 分鐘：對一個實際任務執行 `/ship`，看著你的陣容上場比賽。

尼克隊不是靠五個明星球員搶著投籃贏得冠軍的，他們是靠五個各司其職的角色贏得比賽。你的 Claude Code 設定也能透過同樣的方式變得更強大。

---

感謝閱讀！

我會在我的 Telegram 頻道分享關於 AI、金融與 vibe coding 的每日筆記：https://t.me/zodchixquant

![一名捲髮少年站在佈滿複雜數學公式與幾何圖形的黑板前。](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/bf963a3b6ba86e82.jpg)

<details class="chart-data"><summary>展開畫面重點</summary><div class="me-note">畫面中一名捲髮少年背著背包，站在兩塊寫滿數學公式與幾何圖形的黑板之間。

黑板上的文字與公式包括：
左側黑板：
- 「29.5 97561188160455124」
- 「cruising speed」
- 「|↑&gt; = |↑&gt;」
- 「own a Chargaff's first parity rule - P_A = P_T」
- 「F(n+2) = F(n+1) + F(n)」
- 「λ2k = ... notice that λ_k are linked by λ1, λk = φ」

右側黑板：
- 「hierarchical branching structure of the fractions」
- 「v = 1/4 (15+7√5) a^3 ≈ 7.663118960」
- 「30 edges, 60 face diagonals」
- 「e^cπ = ... (√5 F_n - L_n)」
- 「Euclidean: φ = AC/CB = AB/AC」
- 「K_AADE = 1/2 r (1+φ) = 1/2」
- 「K_ABET = 1/2 r φ = 1/2 r」
- 「K_ACDF = 1/2 (1+φ) r = 1」

前景桌面上放置著檯燈與一些紙張文件。</div></details>

## 標籤

Claude Code, Agent, 教學資源, CLI, Anthropic, Claude