BW Better Workflows 快速導覽QUICK GUIDE · 3.4.13

5–10 分鐘快速建立心智模型

先看懂控制面,再深入原始碼。

Better Workflows 的重點不是「agent 做了多少」,而是 每一個關鍵結論是否有新鮮、可重驗、綁定正確來源的證據

8 個權威邊界 3 種 replay 101 種 evidence 約 8 分鐘
以典藏帳冊、證據印記、重播迴圈與對帳節點構成的 Better Workflows 控制面插畫
INTENT → EVIDENCE → COMPLETION把「我做完了」變成一條可以回放、驗證與對帳的證據鏈。

01 · CONTROL FLOW

一條請求,怎麼走到可證明完成

先記住資料與權威的方向。關鍵不是步驟數,而是任何一個 binding 失配都必須停下。

01 · ROUTE選路與模式

意圖、能力與風險決定 template / mode。

02 · FREEZETaskContract

凍結 goal、scope、驗收、權限與 stages。

03 · BIND來源綁定

HEAD、index、status 與 sentinel 形成來源身分。

04 · DERIVELedger

Append-only events 重播成 ready / blocked / complete。

05 · PROVE型別證據

Producer、payload、digest 與 freshness 全部要成立。

06 · REVIEW精確審查

Finding 綁 exact diff;P0/P1 必須收斂。

07 · ACT一次性授權

短效 token 只允許固定 executable / argv。

08 · RECONCILE對帳再完成

Provider receipt 與最後 sentinel 決定終態。

02 · MENTAL MODEL

四件事,不能互相代替

這是理解整套系統最重要的分界:成功執行不等於有證據,有證據也不等於外部世界已完成。

01

執行成功

命令或 agent 回傳成功,只說明那次執行沒有直接失敗。

02

證據有效

證據必須符合 kind、producer、schema、freshness 與 digest。

03

外部已對帳

Provider 的實際狀態必須由 receipt 或查詢重建,而非相信本機呼叫。

04

可以宣告完成

重驗 ledger、review、evidence、sentinel 與 side effects 後才有終態。

03 · ASSURANCE MODES

Mode 是驗證強度,不是 agent 數

風險提高時,系統增加 governed run、fresh evidence、獨立 critics 與 fail-closed gates;mutation authority 仍在 root。

LEVEL 1 / 4

direct

低風險、可回復;root 直接執行,不建立 governed run。

LEVEL 2 / 4

verified

新鮮證據,加上 1–3 個唯讀 reviewer 做交叉驗證。

LEVEL 3 / 4

deep

在 verified wave 後加入獨立 Codex critics 與 broad review。

LEVEL 4 / 4

critical

不可逆副作用要求完整 authority、exact critic 與 reconciliation。

FULL FIELD GUIDE

心智模型有了,接著看證據與原始碼。

完整版包含 15 個章節、互動式架構圖、mode / template 比較、Ledger 實驗室、Self-improve witness 計畫與 60 個 source locators。

開啟完整版