v1.4.0 — LAT runtime、QA effort 與審查契約

修改重點

• 新增 LAT runtime stdout/stderr、boundary、lock 與 PID 記錄，並以 Session JSONL 作為完成狀態的權威來源。
• 將 code phase 收斂至 lat-code，同主機優先使用 native subagent routing。
• 審查重跑會帶入前輪 findings、base commit 與 incremental diff，確保修正後重新驗證。
• code/test/QA 預設使用 Terra/medium；疑難測試可使用 Terra/high。
• QA 指定 Sol 但未指定 effort 時由 low 起步，只有 QA_INVALID 才依 low → medium → high 升級，且 high 封頂。
• PRODUCT_FAILURE 維持原 QA effort，轉交 test executor 修正；TOOL_OR_ENVIRONMENT_FAILURE 維持 effort 並補充診斷證據。
• QA_INVALID 會建立專用的 correction QA task/prompt，並保留 ledger lifecycle 與歷史。
• Codex cross-host exec launcher 必須由獨立長存、無 PTY 的 exec session 前景持有；Monitor 使用另一 session，完成後等待 launcher EOF，避免短命 parent shell 中的背景程序被中止。
• Codex 等待與監控節奏統一為 300000 ms。

升級注意

• QA effort 不再依「失敗次數」無條件提高；Dispatch 必須先依證據分類失敗原因。
• 既有 client 若以 command & 啟動 launcher，應改為長存 exec session 並保留其 session_id。

驗證

• skill-contract、exec-client、monitor-session、native-subagent-contract 全數通過。
• Bash syntax、ShellCheck、agentskills validate 與 git diff --check 通過。
• repo、Claude 與 agents 安裝副本內容一致。
• Terra QA 通過；Fable 5/medium 完整審查與增量複審皆通過。

v1.3.1

修改重點

• 強化 exec client 生命週期管理：啟動時捕捉實際 PID，保存 control handle，程序退出後安全清理 PID file。
• 明確化 stall 處理：單次 STALL 僅觸發 Dispatch 診斷，不直接終止 client；確認失敗後才使用 PID 或 zmx session 精確介入。
• 將 spec／plan review stall 預設提高至 10 分鐘；Claude Code Monitor 外層採 1 小時 persistent 等待，仍由 COMPLETED、INCOMPLETE 或 STALL 結束監控。
• 新增 Codex INCOMPLETE 狀態：turn 已完成但缺少 Final Answer 時立即回報，避免誤判為一般停滯。
• writer 與 reviewer 可在需要最新技術文件時使用既有 Context7 MCP，不新增 CLI、skill 或其他權限變更。
• plan reviewer 預設改為 Dispatch SELF review；仍可由使用者覆蓋為外部 reviewer client。
• 補齊相關規格、操作文件與 regression tests。

v1.3.0

重點

• 統一 Codex／Claude exec 與 TUI 的原始 Session JSONL 監控及完成判定。
• 每個 TASK_ID 使用獨立 workspace，永久保留任務狀態與執行結果。
• Spec／Plan Reviewer 採 report-only，由 Dispatch 獨立查證並裁決 findings。
• agent_id 統一為 <phase>_<instance>_<task_id>；resume 原 transcript 時沿用 instance，所有 Prompt 共用同一 agent_id。

Full Changelog: v1.2.0...v1.3.0

v1.2.0

自 v1.1.0 的重點變更

新功能

• Sub-Agent 異常診斷流程 — 當任何 phase 的 sub-agent 回報工具相關錯誤（如「沒有權限」「沒有此工具」），Dispatch 不信其自我診斷、不代做任務，而是：驗指令 → 查主機 session JSONL → 通知 sub-agent 真正原因讓它自行修正。同類錯誤通知 3 次未解決則暫停回報使用者
• spec_reviewer / plan_writer prompt 模板 — 所有委派外部 client 的 phase 現在都有明確的 prompt 模板，開頭帶 [<agent_id>] 以便在主機 session 目錄中定位對應的 JSONL 進行診斷

改進

• task_id + agent_id 命名規範 — 統一 task_id（Spec 檔名）與 agent_id（<phase>_<round>_<task_id>）的命名規則，貫穿整個 LAT pipeline
• lat-dispatch / lat-runner 更名 — 從 loop-dispatch/runner 更名以避免與 Claude Code /loop 指令衝突
• Codex CLI flags 修正 — --approval-policy 改為 --ask-for-approval，--full-auto 改為 --sandbox
• README 新增技能更新指令 — 說明如何更新已安裝的技能

v1.1.0

自 v1.0.0 的重點變更

新功能

• 新增 three-tier-testing 技能 — 單元／整合／E2E 三層測試架構：目錄歸屬判斷、裸跑只跑單元測試、Python（pytest）與 TypeScript（Vitest + Playwright）設定
• 驗收測試目錄 tests/qa_e2e/ — qa_executor 依規格 QA 清單撰寫、修實作方只能執行不得修改、裸跑不包含
• test/QA 驗收迴圈 — test_executor 寫整合與 E2E 測試修到綠，qa_executor 驅動真實應用逐條驗收，失敗回饋修正直到全過
• Client 操作獨立成 references/clients.md — 指令格式、解析優先序、內建預設、監控腳本、錯誤處理、Session 恢復集中一處
• 權限維度系統 — 各階段可設定 permission：Claude 用 --permission-mode（plan / acceptEdits / bypassPermissions），Codex 用 --sandbox（read-only / workspace-write / danger-full-access）+ --ask-for-approval never

修正與改進

• 專案更名 CoWork → LoopAgentTeams
• Claude session 恢復改為名稱方案（--name 啟動、--resume <名稱> 恢復），實測驗證 -p 模式接受 session title、名稱不存在時乾淨報錯不卡住；決策脈絡見 docs/claude-session-resume.md
• tui 監控腳本 STALL 改為 break — 單次警報後交由 dispatch agent 處理，與 exec 腳本行為一致；zmx session 不受影響
• zmx 安裝指令更新 — 對應 0.6.0 的 tar.gz 發行檔，補 macOS 安裝方式
• README 與講解文檔同步修正（舊 client 名稱、監控表補 test/qa 階段）

v1.0.0

LoopAgentTeams v1.0.0

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

使用者提出需求後，經過互動式腦力激盪確認方向，後續的規格審查、計劃產生、任務派發、背景執行、進度監控、結果驗收由系統自動串接。

核心功能

• 完整生命週期自動化 — spec → plan → dispatch → monitor → verify 一條龍流程
• YAML 佇列解耦通訊 — Dispatch 與 Runner 透過 tasks.yaml / results.yaml 解耦，不依賴特定 Agent 框架
• 多 Client 支援 — claude-tui、claude-exec、codex-tui、codex-exec 四種執行方式
• 跨模型協作 — 不同階段可使用不同模型（Opus、Sonnet、GPT 等）
• zmx 背景執行 — Runner 在獨立 session 中長時運行，人類可隨時 attach 介入
• 兩層監控 — 存活檢查（STALL）+ 偏離檢查（DRIFT_CHECK），無硬性 timeout
• exec log 擷取 — spec/plan/dispatch 各階段留存執行紀錄

安裝

npx skills add obra/superpowers
npx skills add ouob-tw/LoopAgentTeams