swarm | 平行切片與覆蓋彙整
本頁以 pstack-claude 0.9.126 為基準。swarm 先規劃工作形狀，再派出多名工作者，最後回傳一份整合報告。
定位與適用情境
假設購物車變更已完成，現在要分別驗證價格計算、優惠券與付款接續。這三片能獨立檢查，可以讓各工作者負責一片，再確認三片都有結果。
這種切片分工不同於 arena 的同題競賽。arena 要候選解同一題、選基底並合成。swarm 也支援同題競速或混合形狀，但重點是依預先宣告的規則彙整，不強制選基底移植。
準備
- 定義完成條件 (Done Predicate)，例如三片指定測試都對同一提交完成，且沒有未處理的已確認錯誤。
- 準備實際提交雜湊 (SHA)、測試命令與可讀範圍。若評估未提交差異，須清楚交代各工作區取得了哪些變更。
- 建立覆蓋表，列出切片、負責工作者、輸入版本、驗證方式與狀態。
- 若要寫檔，各自分配工作樹或輸出目錄。Claude Code 的子代理在同一台機器上運作，不會自動獲得隔離環境。
操作步驟
- Frame。 宣告切片、競速或混合。購物車案例採三片覆蓋。若採競速，先選
first pass、rank all或best-of，不能看到結果才換規則。 - Fan out。 一次派出工作者。每份任務都能獨立閱讀，包含目標、精確切片、SHA、命令與回報格式。量測任務另列樣本數、單次樣本定義與執行順序。
- Aggregate。 讀取每個最終結果，確認記錄了指定 SHA 與方法。缺資料者重新派工一次，第二次仍缺就記缺口。覆蓋模式要求每個必要切片都有有效結果。
- Report。 回傳單一結果表、可證實問題、缺口與退出者。競速模式另列選擇規則。不要把工作者原始輸出整段貼回去。
可直接使用的提示詞
Claude Code 可用 /pstack:swarm，Codex 插件可選 $pstack:swarm。貼上前，把方括號替換成真實 SHA 與既有命令。
用 pstack:swarm 唯讀驗證購物車變更，採切片覆蓋，不是同題競賽。
基底 SHA 為 [實際基底 SHA]，待驗證 SHA 為 [實際目標 SHA]。
切片為價格計算、優惠券與付款接續，各自只負責一片。
先從專案找出每片既有的驗證命令，不自行安裝或建立外部測試服務。
每位工作者須回報 SHA、命令、實際輸出與 PASS、ISSUES 或 BLOCKED。
可證實多個問題時全部列出。沒有工具或資料時標缺口，不以猜測補齊。
最後給覆蓋表，任何必要切片缺結果都不能宣告整體通過。預期結果與驗收
| 切片 | 應有證據 | 可接受的狀態說明 |
|---|---|---|
| 價格計算 | 指定 SHA、計算案例命令與結果 | PASS 或具體失敗 |
| 優惠券 | 指定 SHA、折扣限制案例與結果 | PASS、ISSUES 或阻塞原因 |
| 付款接續 | 指定 SHA、接續流程檢查與結果 | 不可用其他切片結果代替 |
表格描述預期交付，不是本頁已執行的結果。BLOCKED 或缺報告都不算通過。彙整者仍要核對證據，不能只計算 PASS 數量。
限制與權限
原文使用 Agent、general-purpose 與背景派工。Codex 對應 spawn_agent，但是否可用仍取決於主機能力與容量。沒有多代理時可明說改為序列檢查，不宣稱完成平行覆蓋。
失去一位工作者可繼續收集其他結果，但其切片仍是缺口。派出更多工作者也不會自動補上未定義的整合邊界。
唯讀驗證不授權工作者修程式、commit 或 push。若另行授權修改，仍須隔離寫入與人工審核整合差異。