01 / DECIDE
架構決策
當專業分工或 context isolation 能改善工作,且不造成重疊 write ownership 時採用。
Handoff 應帶有單一 goal、bounded context、allowed tool、authority、deadline、output shape 與 next owner。 先把 input、output、state 與 side effect 畫成一條可觀察路徑,再決定 讓每次 handoff 都是 typed delegation 要放在哪一層。
02 / BUILD
三步實作
- 01
框定合約
先寫下 caller、資料分類、成功條件、timeout、取消與 ownership。當專業分工或 context isolation 能改善工作,且不造成重疊 write ownership 時採用。
- 02
建立單一路徑
只實作一條 end-to-end path,保留 request correlation、typed state 與可逆 failure handling。Handoff 應帶有單一 goal、bounded context、allowed tool、authority、deadline、output shape 與 next owner。
- 03
證明結果
把驗收寫成可重跑的 fixture、contract test 或 browser test。Handoff test 驗證 context minimization、schema、timeout、cancellation、conflict detection 與 ownership 歸還。
03 / BOUND
Production 邊界
預設不可傳遞 secret 或完整 transcript,也不可讓兩個 agent 同時擁有同一不可逆動作。
04 / PROVE
驗收證據
Handoff test 驗證 context minimization、schema、timeout、cancellation、conflict detection 與 ownership 歸還。
SOURCE / HTTP
可重現來源探針
curl -fsSI 'https://developers.openai.com/api/docs/guides/agents' | sed -n '1,5p'