Rive

Rive 是本地优先 agent team runtime 的体系文档。

章节

Rive 当前已经不只是协议文档，而是可本地 dogfood 的多智能体 runtime：

Work DAG：用 rive work ... / team work ... 建立可追踪的任务图、依赖、accept/reopen/retry 语义。
Reusable workflow：workflow.yaml + prompts/*.md 可导入为 immutable template version，再用 rive workflow run 重复实例化和执行。
Scheduler：rive scheduler run/status/resume 能按 DAG ready node 调度 worker pool，支持 retry/resume、失败分类和可观测 activity。
Node-level runner policy：workflow node 可声明 runner: opencode|codex、worker、workspace_mode、acceptance_mode；同一个 scheduler run 内可以混合 OpenCode cheap worker 和 Codex judge/merge node。
Worker workspace isolation：--workspace-mode worktree 让 worker patch 先进入隔离 worktree/ref，commit/accept 后才合入 parent workspace。
Recovery UX：rive scheduler resume --failed、rive work retry、rive branch conflict show/reject/retry-from-parent 用 ledger 方式恢复失败和 patch conflict。
Debug/usage：debug trace、stdout/stderr refs、scheduler activity、usage read model 都只做诊断，不参与成功判断。

核心边界：成功只来自 ledger/projection（Work DAG、dispatch、scheduler、workflow state），不能从 runner stdout、final answer 或 trace 推断。

Rive agent skill — 给 Codex / OpenCode 等外部 agent 读取的 Rive 操作手册，用来把用户目标组织成 Work DAG、调度 worker、集成 worktree ref，并按 ledger/projection 回报结果。

Rive 启动 OpenCode / Codex worker 时不会假设自己来自交互式 shell，因此不要依赖 ~/.zshrc 一定会被加载。外部 provider key、证书路径等运行时变量可以放在：

文件格式是简单的 KEY=value 或 export KEY=value。Rive 会在启动 runner child 前加载这些变量，然后再写入自己的 RIVE_* 协议变量和 PATH，避免 env 文件覆盖调度协议。

Eino technical manual dogfood — 用 Rive Work DAG + OpenCode workers 阅读 CloudWeGo Eino 代码并产出技术手册的真实 dogfood 示例。
Google ADK Go code-reading dogfood — 用 Rive Work DAG + OpenCode workers 粗读 google/adk-go，按目录分区产出中文架构大纲和总纲。
Sentinel reusable workflow template — 可导入/复跑的生产 debug workflow 模板包，包含 DAG 和节点 prompt。