適用情境
這個流程適合「agent 可以自主做大量工作,但某些節點必須由人或遠端 reviewer 核准」的任務,例如大型 refactor、資料遷移、權限模型改造。
1. Drydock:先確認 repo 與交付規則
以 opt-in drydock harness 建立 repository 交付基準,包含文件語言、規則與需要保留的 evidence。這一步不等於開始改 code。
2. Launch:進入 governed delivery
使用 Shipyard 的 launch pipeline 開始工作。所有後續進度都應對齊已定義的 scope 與 completion criteria。
3. Yard gate / C5 sediment:先收斂再宣告完成
主要實作完成後,不立刻結案。v5.2 的 yard gate 與 C5 sediment pass 用來檢查殘留問題、未收尾 evidence 或看似完成但尚未真正閉環的工作。
4. Remote approval + checkpoint
在需要人工核准的 graph gate,v5.3 會把 approval 與 workspace checkpoint 對應起來。Reviewer 核准的是一個可識別狀態,而不是模糊的「目前看起來可以」。
5. 失敗時 rollback
核准後若後續步驟發生錯誤,以 checkpoint 為回復基準。Rollback 的目的不是掩蓋失敗,而是讓工作區回到已知、可重試的狀態,再重新取得必要 approval。
關鍵原則
- Explicit model / provider configuration 不應被 team scale-up 覆蓋。
- Approval 與 execution authority 要分開。
- 完成狀態必須有 gate,不以 agent 自我宣告為準。
- Checkpoint 必須與被核准的 workspace state 對得起來。