01 / DECISION
何時值得加入這個 primitive
當 multi-step operation 必須跨越時間、transient failure 或 human-in-the-loop pause 時使用 Workflows。
02 / ARCHITECTURE
建立最小且站得住腳的路徑
拆成有名稱且 idempotent 的 steps、只保存 serializable outputs、限制 retries、定義 terminal states,並在不洩漏 payload 下公開 status。
- 01先命名 contract
當 multi-step operation 必須跨越時間、transient failure 或 human-in-the-loop pause 時使用 Workflows。
- 02只加入一個 primitive
拆成有名稱且 idempotent 的 steps、只保存 serializable outputs、限制 retries、定義 terminal states,並在不洩漏 payload 下公開 status。
- 03保留 failure evidence
讓中間 step 失敗、延遲後恢復、送入 external event,確認只有一次 final effect 且 history 可檢查。
03 / REPRODUCE
有證據,再有信心
讓中間 step 失敗、延遲後恢復、送入 external event,確認只有一次 final effect 且 history 可檢查。
npx wrangler workflows list 04 / BOUNDARY
Production boundary
若每個 step 沒有 idempotency strategy,retry 會重複 side effect;workflow 也不能取代 authorization。
05 / FIRST-PARTY SOURCES
讓第一方來源保持權威
產品行為、限制、價格與供應狀態會改變;採取行動前請重新核對這些來源。