Engineering Workflow · v12 · Agent Team Iterate + Challenge

AI 驅動開發流程

Phase 1/2/3 統一「Skill 生成 → 人工 Review → 文件」三段式 iterate。BRD + 測試案例 → UI/UX → SA → Agent Team → PR → Code Review → BU 模組驗收 → Prod

節點角色（顏色）

人類（BU / SA / PG / 團隊）
AI Agent（Skill / Teammate / Lead）
系統 / 文件（依 phase 顏色）

節點形狀

角色 / 起點
流程 / Step
文件 / Artifact
Skill / Agent
決策 / Gate

連線

主流程
觸發 / push / bypass
✓ 通過
✗ 不通過 / 回退

⚠️ v12 變更紀錄（Agent Team 實測修正）

  1. 節點按角色上色：橘色 = 人類（BU / SA / PG / 團隊 / Review 把關）；紫色 = AI Agent（Skill / Teammate / Team Lead）；其他保留 phase 顏色（系統 / 文件）。
  2. 測試案例用途修正：給 Phase 8 BU 模組驗收用（不是 QA Teammate）。QA Teammate 只做 BE/FE code 單元測試。bypass 線從 TEST_CASES 直接拉到 BU_UAT。
  3. UI/UX 嵌入 BRD（layout v11.1 修正）：主流程恢復 UIUX → SA 實線（label「BRD + UI/UX」表達整合包）；UIUX → BRD 改成左側短弧虛線（label「同步嵌入畫面區塊」），純粹表達資料同步副作用。拿掉原本「BRD → SA」那條多餘虛線，避免左 lane 兩條重疊。
  4. BU UAT fail → 回 Team Lead（不是 hotfix PR）：因修 code 也是 AI 來修，直接讓 Team Lead 重新派工。
  5. Phase 8 視覺修正：拉開 BU 模組驗收 ↔ Deploy Prod 距離，避免 ✓ approve label 重疊。
  6. Phase 1/3 Review iterate pattern（v10 既有）：「Skill → 人工 Review → 文件」三段，Review fail 才迴圈回 Skill。三個 phase 風格一致。
  7. Phase 7 簡化（v10 既有）：PR → 直接到 PG Code Review → Merge
  8. Code Review fail 雙路徑：① 程式碼問題 → 回 Team Lead 重新派工；② 架構問題 → 回 SA 重新討論架構
  9. Teammate 職責明確化：BE Teammate 產 BE Code、FE Teammate 產 FE Code、QA Teammate 做三層對抗驗證（A 獨立重驗不採信自報數字 / B spec↔實作對照 / C 對抗測試）——與 team-lead.md §2.5 對齊（原「只做單元測試」低估了 QA 範疇）
  10. P6 加 fail 迭代迴圈（v12）：QA 驗證 ✗ → 退回 BE/FE 修 → 重驗，直到 A/B/C 全綠才匯流到 feature branch。原圖為單向瀑布、無回頭路；實測這個 loop 才是 brownfield iterate 的本體。
  11. Team Lead 駐 P6 當對抗質疑者（v12）：Team Lead 不是 Phase 5 派完工就離開——在 P6 全程對每個非顯然共識至少質疑一輪、仲裁 teammate 辯論。實測發現自主 team 會「自信收斂到看似合理其實錯誤的共識」，須靠 Team Lead challenge 才翻盤；headless CI 尤其依賴此防線。
  12. BE→FE→QA 改為平行起跑 + 整合收斂（v12）：①②③ 為預設順序，但非硬序列——FE 依 SA spec 的 API contract（非 BE 完成的 code）可平行起跑、QA 可先讀 spec 擬對抗計畫；真正硬依賴只在整合測試點。隊友溝通為 mesh（補 QA↔BE「bug 回報 / 辯論」通道），非單向 chain。
  13. BU UAT fail 路由細則：SA 為單一窗口；spec-bug 自改 spec/sa/ + 同步更新 spec/uat/；code-bug 經 PG 確認後手動觸發 Team Lead；每次 fail 累積進 spec/uat/<FEATURE>.md，Team Lead 重派時 QA Teammate 讀整份做完整 regression（詳 doc/designs/2026-05-25-pr-rejection-flow.md §6）