LoopAgentTeams

配合 Superpowers 規格驅動開發的多 Agent 協作技能組。

使用者提出需求後，經過互動式腦力激盪確認方向，後續的規格撰寫與審查、計劃產生、任務派發、背景執行、進度監控、結果驗收由系統自動串接，不需手動介入每個階段的銜接。遇到設計歧義或不可恢復的錯誤時會暫停請求決策。

Dispatch Agent 是協調者，驅動整個生命週期並委派工作給外部 CLI Agent。Runner Agent 在獨立的背景 session 中執行實作任務，完成後寫回結果。每個 TASK_ID 的任務狀態與執行結果都保存在 .lat/workspace/<TASK_ID>/，新任務不會覆蓋舊紀錄。

特點

• 不綁定 Agent 框架 — 任何支援 skills 的 Agent 都能擔任 Dispatch Agent——Claude Code、Codex、hermes、OpenClaw、Pi Agent 等；Agent 間通訊只靠 YAML 佇列與 CLI 指令，沒有框架 API、沒有 SDK
• 不受單次額度限制 — 不依賴 /goal 等一次性自動化指令，任務以 session 持久化執行，不受 Codex 5 小時額度等限制，直到完成為止
• 額度耗盡自動換號 — 搭配 codex-multi-auth，Codex 帳號配額用完時自動切換到下一個帳號，無需人工介入
• 人類可直接介入任意 Agent — 透過 zmx session manager，隨時 attach 到任何背景執行中的 Agent（TUI 模式），即時查看進度或直接輸入訊息，不需要透過 Dispatch Agent 轉達
• 跨模型協作 — 可在不同階段召喚不同模型，例如 Opus 4.8 探索程式碼、Opus 4.6 撰寫文件、gpt-5.6-terra 編寫程式碼，依任務特性選用最適合的模型
• 三層測試隔離 — 依外部依賴將測試分為單元、整合與 E2E；裸跑只執行單元測試，整合與 E2E 必須明確指定，另以 qa_e2e/ 保存規格驗收測試
• 相容未來計費模式 — 若 Anthropic 日後對 claude -p（CLI 同步模式）收費，可直接改用 TUI 模式讓 Agent 操控互動介面，不影響流程
• Runner 擁有完整權限 — 解決 Codex plugin for Claude Code 無法臨時授予 full-auto 權限的問題，Runner 在獨立 session 中執行，權限由啟動時的設定決定

流程

使用者需求
    |
    v
+---------------------------+
|  spec（規格）              |
|  草稿 → 初始化 TASK_ID     |   <-- Superpowers 腦力激盪工作流
|  建立任務紀錄 → Reviewer   |       Reviewer 只報告、不改檔
|  → Dispatch 獨立裁決       |
+---------------------------+
    |
    v
+---------------------------+
|  plan（計劃）              |
|  外部 Writer → Reviewer    |   <-- Writer / Reviewer / Dispatch 三層
|  → Dispatch 獨立裁決       |       規格 + 計劃一起 git commit
+---------------------------+
    |
    v
+---------------------------+
|  dispatch（派發）          |
|  驗證任務紀錄 → 加入任務    |   <-- 一個摘要任務指向計劃檔案
|  啟動 Runner session       |       支援 zmx / CLI 兩種執行方式
+---------------------------+
    |
    v
+---------------------------+
|  monitor（監控）           |
|  存活檢查 + 偏離檢查       |   <-- 兩層監控，無硬性 timeout
|  等待 session 完成標記     |       卡住（STALL）或偏離方向（DRIFT_CHECK）
+---------------------------+       時通知 AI 介入
    |
    v
+---------------------------+
|  test（測試與驗收）         |
|  test_executor：           |   <-- 寫整合 + E2E 測試，修到綠
|    整合 + E2E 測試         |
|  qa_executor：             |   <-- 依 QA 清單寫驗收測試至 qa_e2e/
|    驗收測試 → qa_e2e/      |       失敗回饋 test_executor 修正
|  迴圈到全過或達上限         |       結果透過 workspace 傳遞
+---------------------------+
    |
    v
  回報使用者

審查不是照單全收

Spec／Plan Reviewer 都是 report-only，只提交附證據的 finding，不直接修改文件。Dispatch 逐項查證後標記 ACCEPT、REJECT 或 USER_DECISION；即使 Reviewer 回覆 PASS，仍會對需求範圍、QA 可測試性與高風險假設執行 focused gap scan。只有 Reviewer 與 Dispatch 裁決都完成後，該階段才通過。

安裝

lat-dispatch 的統一 Session Monitor 支援 GNU/Linux 與 macOS。

前置需求：

GNU/Linux（Debian／Ubuntu）安裝 Monitor 相依套件：

sudo apt-get update
sudo apt-get install -y jq uuid-runtime trash-cli

macOS 已內建 uuidgen；其餘相依套件可用 Homebrew 安裝：

brew install jq trash-cli

# 安裝 Superpowers skills（腦力激盪、規格撰寫等基礎工作流）
npx skills add obra/superpowers

# 安裝 LoopAgentTeams skills
npx skills add ouob-tw/LoopAgentTeams

更新已安裝的 skills 到最新版本：

npx skills update

長時任務需要 zmx（發行檔為 tar.gz，內含單一執行檔）：

ZMX_VERSION=0.6.0
mkdir -p ~/.local/bin

# Linux x86_64
curl -fsSL "https://github.com/neurosnap/zmx/releases/download/v${ZMX_VERSION}/zmx-${ZMX_VERSION}-linux-x86_64.tar.gz" | tar -xz -C ~/.local/bin

# macOS Apple Silicon
curl -fsSL "https://github.com/neurosnap/zmx/releases/download/v${ZMX_VERSION}/zmx-${ZMX_VERSION}-macos-aarch64.tar.gz" | tar -xz -C ~/.local/bin

其他架構（Linux aarch64、macOS Intel）將檔名中的架構改為 linux-aarch64 或 macos-x86_64。最新版本見 zmx releases。

用法

在任何支援 skills 的 Code Agent 中觸發 lat-dispatch，會自動從腦力激盪開始跑完整流程：

lat-dispatch 幫我做一個使用者登入功能

可以指定各階段的 client 設定：

spec 用 codex-exec 審查，code 用 claude-tui sonnet 4.6 medium

Runner 通常由 Dispatch 自動啟動，也可以手動觸發 lat-runner。

執行中查看進度

Runner 在背景跑時，可以用 zmx 指令查看：

架構

lat-dispatch/           Dispatch Agent 技能（協調者）
  SKILL.md                  流程定義、監控邏輯
  references/
    clients.md               Client 指令格式、內建預設、監控腳本、Session 恢復

lat-runner/             Runner Agent 技能（執行者）
  SKILL.md                  任務讀取、實作、結果寫入
  references/
    yaml-schema.md          每個 TASK_ID 的任務與結果格式

three-tier-testing/     測試架構技能（三層分離）
  SKILL.md                  通用原則、歸屬判斷、範圍判斷
  references/
    python.md               pytest 設定與指令
    typescript.md           Vitest + Playwright 設定與指令

.lat/                  執行時工作目錄（gitignore）
  logs/                     診斷資料
  workspace/
    <TASK_ID>/
      tasks.yaml            不刪除的 phase/instance 生命週期紀錄
      results.yaml          不刪除的執行結果歷史
      qa-results.md         QA 驗收證據
      prompts/              可依 retention 清理的暫存 prompt

支援的 Client

TUI（Terminal UI）：在終端機中運作的互動式文字介面，可即時交互與顯示執行狀態。

兩層監控

取代硬性 timeout，以存活檢查與偏離檢查確保任務正常推進：

zmx 是什麼

zmx 是輕量級的 terminal session 持久化工具。與 tmux 最大的理念差異在於：zmx 不做視窗管理（pane/window/tab），而是讓每個 session 是獨立的原生滾動終端。本專案用它來背景執行 Runner Agent，Dispatch Agent 透過 zmx 指令監控進度與讀取輸出。

跟 tmux 的差異：

授權

MIT