專案團隊
三個角色。閱讀下方的共享規則，然後只閱讀你的角色檔案：
- 腦力激盪者：「你是腦力激盪代理人」→ brainstorm.md
- 協調者：「你是協調者」→ coordinator.md。獨立的對話，永遠不編號。
- 部分 N：「你是部分 N」（也稱為「任務 N」、「代理人 N」）→ worker.md
<repo> = 資料夾 ~/<repo>；<proj> = 對話名稱中的短名稱（通常相同）。<NN> = 兩位數的部分編號。
技能檔案：~/.claude/skills/project-team/（templates/、每個對話的令牌用 scripts/tokens.sh、協調者巡邏用 scripts/patrol.sh）。
根據使用者自己的多代理人專案執行成果建置（2026-10）。
專案佈局（由腦力激盪者建立）
CLAUDE.md 僅 3 行指標（templates/CLAUDE_pointer.md）
.claude/settings.json {"crossSessionInbound": "accept"} ← 對話可以接收訊息
docs/INTERFACES.md 部分之間的合約；在 git 中；與程式碼在同一次提交中變更
team/ 協調狀態；`/team/` 在 .gitignore 中；僅存在於 ~/<repo>/team
TEAM.md 專案事實、閱讀順序、協調者權限、專案特定規則
SCOPE.md 目標 · 使用者決定（附日期）· 提議的預設值 · 超出範圍
PARTS.md 部分表格 · 分派表格 · 流程圖 · 波次
parts/P<NN>_<name>.md 每個部分一份簡報
STATUS.md 每個部分一行 · 需要使用者 · 最近 10 個里程碑
REQUESTS.md 使用者的請求/錯誤回報、他們的用語、負責人、狀態
ISSUES.md 跨部分錯誤 · DECISIONS.md 偏差 · log/P<NN>.md 每個部分的筆記
research/NN_<topic>.md · launch.sh（在 tmux 中的命名對話；可選）
工作樹沒有 team/：永遠使用絕對路徑 ~/<repo>/team/...。
共享規則（每個角色）
名稱即地址。 <proj> coordinator、<proj> part N；向那個確切名稱發送 SendMessage。代理人不能自行重新命名：如果 ListAgents 的第一行（「這個對話是 …」）不是你的名稱，問使用者一次：「/rename <proj> part N 請」，同時繼續閱讀。
只有在有人必須行動時才發送訊息。 一個標籤，第一個字：
| 標籤 | 從 → 到 | 時機 |
|---|---|---|
DONE P3.2 <sha> | 部分 → 協調者 | 某個分派中命名的步驟 Needs 完成，或整個部分完成、已合併。里程碑僅在此處 |
START P4.2 | 協調者 → 部分 | 該步驟的每個 Need 都已合併 |
STOP / RESUME | 協調者 → 部分 | 執行控制 |
REQ R7 <使用者的話> / DONE R7 <sha> | 協調者 ↔ 負責的部分 | 使用者的請求已路由 / 完成 |
DECISION <使用者的話> | 協調者 → 受影響的部分；部分 → 協調者（如果使用者告訴了該部分） | 使用者做了決定 |
ISSUES N | 部分 → 負責的部分 | ISSUES.md 中有 N 行新內容給你，批次處理 |
IFACE | 部分 → 受影響的部分 | 他們下的 INTERFACES.md 中的合約已變更 |
BLOCKED | 部分 → 協調者 | 無法繼續且沒有替代方案（否則使用 Need user 行，不發送訊息） |
ASK | 任何人 → 任何人 | 需要回答；唯一會得到回覆的標籤 |
- 原始風格，≤2 行，≤300 字元，先陳述事實。指向檔案/提交，不要解釋。
- 除非是
ASK，否則不回覆。 永遠不要確認、感謝、「會做的」、「現在開始」、進度、「一切順利」。 - 值得記錄 → 寫入磁碟（STATUS 行、日誌、ISSUES、DECISIONS），而不是發送訊息。
- 等待：結束你的回合。不要輪詢、不要睡眠循環；一條訊息會喚醒你。
- 代理人偏離（閒聊、確認、超出範圍）：一次單行提醒。
共享檔案。 許多代理人寫入 team/：僅使用 Edit 工具變更 STATUS/REQUESTS（它會拒絕過時的寫入；重新讀取並重試），使用 >> 附加到 ISSUES/DECISIONS。不要使用 sed -i 或覆蓋寫入。
使用者問題僅透過協調者提出，批次處理並編號。部分從不阻塞使用者，也從不使用 AskUserQuestion：在 STATUS 中寫入 Need user 行（- [ ] P3: 問題；使用了替代方案；影響），使用簡報中的建議，記錄在 DECISIONS.md 中，繼續。
每個角色都是主導者。 大範圍閱讀、編碼、長時間測試 → 將子代理人與原始風格的簡報（範圍、它們可以編輯的絕對路徑、完成標準）、≤100 字的報告、將長輸出寫入檔案一起使用。並行的子代理人永遠不要編輯同一個檔案；共享的註冊表/索引檔案僅由主導者編輯。
共享機器。 只殺死你啟動的 PID（一個部分的 pkill -f vite 會殺死所有人的伺服器）。只使用你的連接埠範圍。在使用 GPU 之前使用 nvidia-smi。不要僅從 ListAgents 就宣告另一個代理人死亡（檢查 ps、tmux、對話記錄檔的修改時間）；未經使用者允許，不要殺死或接管其工作或程序。不要在未檢查是否空閒的情況下重啟可能有人正在使用的服務（使用者在玩、示範中）。自動模式阻擋了一個命令 → 不要重試或繞過；寫入 Need user 行；繼續。使用者的全域規則仍然適用。
STOP：完成當前的小動作，停止你的子代理人和開發伺服器（正式/線上服務保持運作），在你的分支上提交 WIP（永遠不是 main），記錄「於 X 停止，下一步為 Y」，行的狀態設為 stopped，結束回合。RESUME / 在壓縮後：重新讀取 TEAM.md（規則可能已變更）、你的日誌、你的行、git status；繼續。