Approving — human-gated multi-agent workflows

Approving — human-gated multi-agent workflows

核心判断

Approving 值得进入 wiki，因为它把多 agent 工作流的可信性落到三个可复用机制上：visual FSM orchestration、sandboxed execution、human approval gates。它的定位不是“让 agent 更聪明”，而是让多 agent 流程在关键节点暂停、回滚、交接 artifact，并在 sandbox 中运行。

这对用户重要：Hermes cron 当前是无人执行，但很多高风险动作（安装工具、改 Hermes profile、接入新 control plane、发布到生产、写入敏感来源）不应无人跨过。Approving 代表一种可迁移的原则：自动化可以推进中间步骤，但 scope freeze、commit、merge、发布、长期 memory 改写等节点应作为显式 human gate。

机制：FSM + sandbox + artifact contract + approval gate

Approving README 中的核心机制包括：

1. Visual orchestration：用 canvas FSM 表达 agent 节点、react 节点、guards、checkpoints、gates 和 failure rollback。
2. Real Docker sandboxes：agent/react 节点在容器中运行，通过 ACP 和 sandbox-gateway 隔离执行环境。
3. Multi-agent backends：Cursor、Claude Code、CodeBuddy、Trae 等 backend 可按 agent meta 选择；平台负责编排边界。
4. Artifact contract：agents 通过 write_artifact / set_* / node_complete 等契约交付产物，每个 run 有隔离 token。
5. Human approve：关键节点必须由人确认后继续，把 trust built into the path。

一阶原理是：多 agent 系统的不确定性不能只靠更强 prompt 解决；需要把工作流状态、环境、产物、审批和回滚都外部化。

与现有 wiki 概念的关系

• 对 Harness-Engineering：Approving 是 containment / workflow harness 的产品形态，强调 blast radius、sandbox、artifact contract 和 gate。
• 对 Loop-Engineering：它适合外层 loop 的高风险节点：自动发现和准备可以无人完成，但继续执行需要 approval fact。
• 对 External-Agent-Skills-Design-Patterns：它说明 skill/workflow 需要明确“哪些节点不能由 agent 自己跨过”。
• 对 Agentic-Coding：它从单 agent 编码扩展到多 agent 编排，但把人类判断嵌入流程，而非让多 agent 彼此互相背书。

对 Hermes / llm-wiki 的可执行启发

1. 给无人 cron 增加 HOLD 类输出：当发现需要安装、迁移、删除、发布、修改 profile/cron 的动作时，radar 应输出待审批建议，而不是继续执行。
2. artifact contract 标准化：deep ingest 可把 raw、source page、concept update、index/log、vector reindex 视为一组 artifact；缺一项则不报告“完成”。
3. 审批节点前冻结 spec：像 QA workflow 冻结 test list 一样，重要 wiki 大规模重构前应先生成变更计划和受影响文件列表，等待人工确认。
4. sandbox 思维用于外部工具试用：Preloop/Omnigent/ContextIQ 这类工具若要试装，应先在隔离 repo / venv / worktree 中验证，而非直接污染主 Hermes 环境。

失败模式与边界

• UI/平台复杂度：对个人知识库维护而言，完整 self-host platform 可能重；更适合提炼 gate/contract 原则，而非立即部署。
• approval theater：如果审批人看不到足够 evidence，点击 approve 只是形式主义；gate 必须附带 diff、测试、风险、回滚方案。
• sandbox 不等于安全：凭证、网络、挂载目录和 MCP 工具仍可能扩大影响半径。
• 多 agent 责任稀释：多个 agent 节点可能让错误归因更难，必须保留 per-node artifact 和日志。

深度判断

晋升理由：Approving 的 star 很低且 repo 较新，但它把 human gates、sandbox、artifact contracts、rollback 组合成清晰方法论，正好补充 Hermes 无人 cron 的审批边界设计。因尚未实际运行验证，标记 medium。

写入记录

• 2026-07-26 09:00 CST：新增 source 页面，沉淀 Approving 的 human-gated multi-agent workflow 机制及其对 Hermes 无人 cron 边界的启发。