AI 工作流的控制契約

工作流完成了。決策有依據嗎?

把 Agent 做過的事,連回證據、授權與實際成果,讓下一個決策有據可查。

0.1 · 可執行候選版本0.2 · 規劃中・尚未發布
一個決策情境

Provider 已完成動作,但成果證據仍然缺少。

execution
COMPLETED
evidence
MISSING
authority
ACTIVE
promotion
HOLD
reconciliation
MATCHED
observedOutcome
UNKNOWN

下一步:收集成果證據,由 owner 決定是否晉級。

情境示意・非實際判定收據

HelmLoop / 概覽

HelmLoop 是不綁定特定 runtime 的控制契約協定。執行、證據、授權、晉級、對帳與觀測成果各有明確狀態;執行與權限仍由原有 host 管理。

HelmLoop

六個不同問題,各自回答。

Graph 到達終點,只回答執行是否結束。下一個具有影響的決策,還需要當次有效的證據、授權與外部實況。

01

execution

Executor 實際做了什麼

02

evidence

必要 claims 是否新鮮且受到支持

03

authority

精確 action 是否獲得授權

04

promotion

Accountable owner 做了什麼決定

05

reconciliation

Provider 與 observed external state 顯示什麼

06

observedOutcome

獨立 outcome evidence 顯示什麼

0.1 / 可執行候選版本

現在可以檢視什麼

Protocol 0.1 已有八種 record schemas、確定性的六軸 reducer、CLI 與兩個 fixture observation adapters。這些是本地實作產物,尚不代表公開套件發布或真實 runtime 認證。

閱讀協定文件 ↗
0.2 / 規劃中・尚未發布

讓下一個決策,有更清楚的契約。

0.2 計畫新增 assurance 軸、授權生命週期事件、criterion 綁定的成果觀測,以及版本化證據採認。這些能力目前仍是 r3 / sync-4 的規劃目標。

查看 0.2 計畫 ↗

HelmLoop

從現有原始碼開始

在本地 HelmLoop source checkout 使用 Node.js 20 以上版本執行。此命令使用 fixtures,不呼叫真實 provider。

獨立的 helmloop try 是 0.2 規劃項目,目前 CLI 尚未提供。

Protocol 0.1 ↗
SOURCE CHECKOUT / FIXTURE
node bin/helmloop.mjs schemas
node bin/helmloop.mjs conformance --adapter core

HelmLoop

責任歸屬,保持明確

排程、狀態、授權、實際動作與業務真相都由 host 持有。HelmLoop 判定輸入的契約與觀測;Better Workflows 是可選接入對象,不是必要後端。

  • completed ≠ PROMOTE

    Runtime completion 不能決定 portfolio 或 release promotion。

  • intent ≠ action authority

    Goal、prompt 或 handoff 不能自行產生 side-effect permission。

  • receipt ≠ business outcome

    Trace 或 provider receipt 只證明事件,不證明下游價值。

  • instance nesting ≠ ownership

    Parent/child topology 不會轉移 resource 或 decision ownership。

  • preference ≠ authority

    Preference 可引導提案,但不能授權 action。

FAQ

直接回答常見問題

HelmLoop 是什麼?

HelmLoop 是不綁定特定 runtime 的 AI Agent 工作流控制契約協定。它分開記錄執行、證據、授權、晉級、provider 對帳與觀測成果,讓 host 能檢視決策的依據。

Protocol 0.2 已經可以使用嗎?

還沒有。目前本地實作是 0.1 候選版本。Protocol 0.2 仍是 r3 / sync-4 規劃,目標包含十種 records、七軸判定;尚無 0.2 套件、runtime conformance 或 production readiness 完成主張。

HelmLoop 一定要搭配 Better Workflows 嗎?

不需要。規劃中的 neutral package 保持獨立;另一個 Better Workflows binding 負責映射 host 已驗證的觀測,不移轉執行責任或授權。

Fixtures 通過就代表可攜性成立嗎?

不代表。Fixtures 只驗證指定案例。即使兩個 mock adapters 和一個 real binding 都通過,也不等於跨 runtime portability;後者需要符合條件的一對獨立真實 runtime 觀測。