OpenRig workflow工作流引擎教程spec缓存、步骤追踪与看门狗策略三大机制【免费下载链接】openrigMulti-agent harness that runs Claude Code and Codex together as one system项目地址: https://gitcode.com/GitHub_Trending/op/openrigOpenRig 是一个多智能体协作框架Multi-agent harness让 Claude Code 和 Codex 作为同一个系统协同工作。它的workflow 工作流引擎负责把谁在哪一步做什么变成可追踪的持久状态spec 缓存让规范文件秒级读取步骤追踪把每一步闭环写入只增日志看门狗策略则在流程停顿时分级唤醒让长时运行的智能体团队不卡死、不漂移。一、工作流引擎在 OpenRig 中的位置在 OpenRig 里一个rig机架由多个 agent 席位组成workflow 则定义了这些席位之间的步骤流转从哪个步骤出发、由谁执行、完成后流向哪里。引擎由三个核心机制支撑对应 packages/daemon/src/domain/ 下的三类模块机制解决的问题核心实现spec 缓存规范文件频繁解析慢、口径不一致workflow-spec-cache.ts步骤追踪步骤闭环状态丢失、无法审计workflow-step-trail-log.ts看门狗策略工作流停摆、owner 失联watchdog-policy-engine.ts二、spec 缓存文件是唯一事实SQLite 只负责快工作流规范workflow spec由操作者用 markdown/YAML 文件编写存放在工作区里。OpenRig 的读透缓存read-through cache设计要点是懒加载 哈希失效daemon 首次读取时把 spec 解析进 SQLite 的workflow_specs表并记录文件内容的source_hash下次读取时哈希不一致就重新解析因此你修改文件后改动在下次读取时自然生效文件永远赢缓存注释里明确写着 the cache is never the source of truth——缓存只为快速查询服务不会反过来篡改文件内容统一查询入口内置 starter 规范与用户自定义规范走同一张表spec-library-workflow-scanner.ts 直接读缓存行生成拓扑图投影保证rig workflow specs命令看到的与库界面完全一致相关数据库迁移033_workflow_specs.ts、034_workflow_instances.ts、035_workflow_step_trails.ts。三、步骤追踪append-only 的闭环日志每次一个步骤结束done / failed / waiting 等引擎都会向workflow_step_trails表追加一条记录包括步骤 ID 与角色step_id、step_role闭环时间与闭环原因closure_reason附带的闭环证据closure_evidence执行者会话actor_session与前后队列项 IDworkflow-step-trail-log.ts 的 API 层只暴露record()方法——没有 UPDATE、没有 DELETE从接口层面杜绝篡改。实例当前执行到哪个步骤则记录在workflow_instances表的current_step_id与current_frontier_json前沿步骤集合支持并行分支中。这套实例状态 只增轨迹的组合让审计、恢复和回放都有了确定性依据。四、看门狗策略三级干预栈而不是无脑定时提醒长时运行的工作流最怕owner 席位卡住后面全等。OpenRig 的看门狗watchdog不追求每 tick 都做同样的事而是按证据选择干预级别形成三级栈级别目标触发场景Wake唤醒重启动作owner 空闲、失联、缺少下一步交接Refocus重聚焦纠正漂移输出出现模式漂移、审批倒退、停止条件推理弱化Alignment checkpoint对齐检查点重建共享地图阶段边界、生命周期变更、产品意图决策几个对新手很实用的设计原则完整规范见 watchdog/SKILL.md扫描频率与唤醒频率分离可以每 30 秒扫描一次状态但唤醒至少间隔 600 秒避免提醒轰炸污染工作流安静跳过不记账调度轮询中大量的无事发生不会写入历史只有真正发出sent或终结terminal的评估才留痕keepalive 策略只读 SQLiteworkflow-keepalive.ts 直接从workflow_instances表读状态只在前锋步骤逾期时才向 owner 席位发送提醒正常路径上零噪音七种失败模式清单技能文档里逐条列出唤醒错席位refocus 被误读成新任务提醒变成官僚化表演等常见坑帮你避开CLI 侧对应 workflow.ts 与 watchdog.ts 两组命令配合rig workflow查看实例状态、rig watchdog管理策略。五、快速上手建议先阅读 watchdog 技能规范理解三级干预栈再配置任何唤醒策略编写工作流规范时记住文件即事实改完 YAML 即可缓存会自动按哈希失效重建排查卡顿时优先查workflow_step_trails轨迹只增日志不可篡改确认是哪一步、被哪个会话闭环、原因是什么宁可用一个 workflow 看门狗 针对性例外处理也不要给每个席位都挂提醒循环这套 spec 缓存 步骤追踪 看门狗的组合正是 OpenRig 能把多个 AI 编码智能体当作一个系统长期运转的底座状态确定、轨迹可审计、停摆有兜底。【免费下载链接】openrigMulti-agent harness that runs Claude Code and Codex together as one system项目地址: https://gitcode.com/GitHub_Trending/op/openrig创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考