# HelmLoop — AI Agent 工作流的控制契約

> HelmLoop 為 AI Agent 工作流明確定義授權、證據、晉級與成果邊界。了解可執行的 0.1 候選版本，以及規劃中的 0.2 協定。

Source: https://helmloop.dev/zh-Hant/

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

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

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

## 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 觀測。

## 依實際範圍閱讀證據

現有 fixture 結果不認證真實 runtime、全面可攜性、production readiness 或業務价值；研究頁保留這些待驗問題。