Agent 的角色、輸入與交接

本頁是新流程的操作要求。dcx open 已提供 opt-in 產品的品質狀態、下一步、實際工具／目錄及具名操作入口；正式產品尚未啟用。接線與request格式見使用指引。

開工與續接

從產品 contract repo 既有入口執行 ./dcx open <ticket> --role <role> --json（代入實際票號及角色）。確認 product、ticket、ownership、版本與工作目錄，再讀工具列出的權威檔案；缺資料時找對應 owner。不能把呼叫者選的 --stage 當成系統已完成的整體進度。

quality_workflow 工作包包含各並行節點的有效狀態、待辦／等待原因、可用命令與參數、輸入／產出、核准與交接條件。每次寫入或觸發 CI 前重新核對；命令未接線時顯示限制，不靠 Agent 編造操作。各產品沿用同一工具與角色指引，產品路徑、技術棧和環境由設定提供。

各角色交什麼

角色	Agent 工作	人負責決定
PM	整理 spec／AC、版本與待決事項，回應需求歧義	需求意義、範圍與版本
UI／設計	整理路由、畫面狀態與互動約定；無 UI 時由指定 owner 接手	設計與使用者行為預期
BE	補固定 API、錯誤／副作用、啟動與資料介面；實作、自驗、跑 QA BE 驗收、提交修復	技術決策與程式審查
FE	補可觀察畫面行為及啟動介面；依契約 mock 開發、自驗、跑 QA FE 驗收	技術決策與程式審查
QA	先列情境；介面可用後寫腳本；整理報告、協助探索、開 Gap／轉派／重驗	業務標準、指定版本人工驗收、Gap 轉派與解除
技術 reviewer／整合 owner	審測試是否真的驗得到；固定部署與整合，核對演練證據	以實際授權身分作核准；責任名稱不自帶權限

QA 案例設計與腳本可由同一 Agent 接續；開發與 QA 腳本化並行。測試程式由 QA 維護在獨立 QA repo 或 contract repo 的 qa/（IM 採後者），各端 CI 取核准固定版本執行，不轉交 BE／FE 自行放寬標準。

給 QA 測試作者的輸入

固定 spec／AC／資料規則與已核准情境，列出待決項。
固定 BE API／錯誤與副作用、FE 畫面狀態與操作約定。
已有時提供測試 URL、啟動／停止、ready、資料準備／重置與觀察方法。
QA repo 的可寫範圍、測試框架／版本、必要案例對照、輸出及 reviewer。

測試 expected 必須依契約，不提供開發實作 diff 或推理來倒推答案。可以黑箱操作指定產物、協作測試入口；介面不足先回報。新對話或不同模型只隔離部分上下文，普通 worktree 仍可能看到整份實作；若要求實作不可見，派工端須真正限制 workspace／工具可讀範圍。

輸出要區分「案例已設計」「腳本已撰寫」「未執行」「失敗／出錯」「通過」，附 AC → case → 斷言對照、資料與 mock、必要版本及真實原始結果。QA／產品負責人審業務預期，技術 reviewer 審 case、fixture、adapter、harness 與 CI；作者 Agent 不自批。技術 reviewer 不限定 QA 組長，允許與 QA 同人兼任；request 以 review_role 分別記錄兩項職責，不把單次核准當成兩項都完成，QA 最終接受仍另行確認。

故障作者是另外的任務

正常版本與核准測試跑通後，QA Agent 可建議重要錯誤和預期失敗案例。QA＋技術 reviewer 確認適用性與範圍，再派故障作者。

派工寫清基底／測試版本、隔離程式與服務／資料、唯一故障、可寫路徑、復原與輸出。故障作者可以讀取和修改隔離實作，測試保持唯讀；不得再把這個已看實作的上下文冒稱為盲寫測試。保存正常綠、指定斷言紅、復原綠，最後由人審查。

QA 驗收與缺陷

整合結果可信且固定產物可驗收時，QA Agent 呈現版本、範圍、自動結果、人工項目與 Gap。由人明確表示接受／退回，工具核驗人的身分及版本後寫入；一般 Run accepted 不等於產品 QA accepted。

發現功能錯誤開同一套 Gap，附 AC、重現與版本證據。被指派端只能提交修正或轉派建議，QA 負責轉派及重驗解除。對新版本重測失敗情境及相關回歸後，QA 再作整體接受。

目前可直接執行的驗收教學見 BE 範例，共用操作已實作；產品 API／CI／通知仍需真實owner與配置接線，不可把fixture當正式驗收。