OpenRig RigSpec完整字段参考575行参考文档带你逐字段读懂v0.2格式【免费下载链接】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 编进同一个 Rig协作小队统一管理。而RigSpec就是 OpenRig 的核心配置格式——一份rig.yaml文件用 YAML 定义你的 Agent 团队谁参加、用什么运行时、坐在哪个目录、谁向谁汇报。本文带你逐字段读懂 v0.2pod-aware格式全部依据官方 575 行参考文档 docs/reference/rig-spec.md 整理字段语义均追踪自真实解析器代码 packages/daemon/src/domain/rigspec-schema.ts。最小可用 RigSpec7行定义一个团队version: 0.2 name: my-rig pods: - id: dev label: Development members: - id: impl agent_ref: local:agents/impl profile: default runtime: claude-code cwd: . edges: [] edges: []只有version、name、pods三样是硬性要求版本号必须是0.2至少一个 Pod每个 Pod 至少一个 Member。官方演示仓库里的 demo/rig.yaml 就是一个完整可运行的例子配了 demo/culture.md 团队文化文件。顶层字段一览给 Rig 起名和装上下文字段类型必填默认说明versionstring✅—必须为0.2namestring✅—用于会话命名{pod}-{member}{name}与快照识别summarystring❌—人类可读描述显示在 spec 库和rig specs showculture_filestring❌—团队文化/宪法文件安全相对路径permission_policystring❌—内置builtin:locked/standard/open/yolo或自定义策略文件managed_blocksmap❌CLAUDE.mdClaude Code 成员接收托管指令块的文件docsDoc[]❌—随 Rig 打包的文档供人与 Agent 环境搭建时参考startupStartupBlock❌—Rig 级启动文件与动作servicesServicesBlock❌—Docker Compose 托管服务先于所有 Agent 启动podsPod[]✅—至少一个 PodedgesCrossPodEdge[]❌[]跨 Pod 边必须用pod.member全限定 ID两个高频细节权限策略permission_policy: builtin:standard引用内置策略或policies/my-cautious-dev.policy.md引用自定义策略文件官方示例见 packages/daemon/policies/examples/my-cautious-dev.policy.md。Member 级设置优先级高于 Rig 级。Claude 指令文件如果你的仓库已经 git 跟踪了CLAUDE.md建议managed_blocks: { claude-code: CLAUDE.local.md }让 OpenRig 把托管指令块写进不入库的文件只接受CLAUDE.md和CLAUDE.local.md两个值。Pod 字段详解把成员装进舱Pod 是 RigSpec v0.2 引入的有界上下文bounded context一组协同工作的 Member 和 Pod 内部的关系边。字段类型必填默认说明idstring✅—不能含点号.Rig 内唯一构成会话名第一段labelstring✅—人类可读名称显示在 UI 与图谱分组summarystring❌—Pod 描述continuity_policyContinuityPolicy❌—压缩恢复与同伴驱动恢复策略startupStartupBlock❌—Pod 级启动文件与动作membersMember[]✅—至少一个成员edgesPodLocalEdge[]❌[]Pod 内部边必须用不带前缀的成员 IDMember 字段详解每个 Agent 座位的配置字段类型必填默认说明idstring✅—Pod 内唯一不能含点agent_refstring✅—指向 AgentSpec须以local:或path:开头profilestring✅—AgentSpec 中的档案名常用defaultruntimestring✅—claude-code/codex/terminalcwdstring✅—工作目录相对 Rig 根解析.表示根目录labelstring❌—显示名称modelstring❌—模型覆盖如claude-opus-4-6restore_policystring❌resume_if_possibleresume_if_possible/relaunch_fresh/checkpoint_onlycodex_config_profilestring❌—Codex 原生 profile-p name仅限字母数字_ . -startupStartupBlock❌—仅对该成员生效的启动块三条关键规则终端节点三件套基础设施进程服务、日志监视必须同时写runtime: terminalagent_ref: builtin:terminalprofile: none三者缺一不可写一半直接校验失败。agent_ref 引用规则local:相对 Rig 根目录、path:必须是绝对路径且目标目录里必须有agent.yamlAgentSpec 格式详见 docs/reference/agent-spec.md。会话命名公式{podId}-{memberId}{rigName}例如 Poddev 成员impl Rigmy-team→ 会话dev-implmy-team。Edges 字段详解5 种关系决定协作方式Kind含义是否约束启动顺序delegates_to源向目标委派工作orchestrator → 实现者✅spawned_by目标由源生成父子层级✅can_observe源可观察目标输出reviewer → 实现者❌collaborates_with对等协作❌escalates_to源向目标升级决策❌⚠️最容易踩的坑是 ID 格式Pod 内部边用裸成员 ID ——from: impl而不是from: dev.impl跨 Pod 边必须用pod.member全限定格式 ——from: orch.lead且两端必须属于不同Pod两端同 Pod 时校验器会报错提示你改用 Pod 内部边edges: # 跨 Pod 边全限定 ID - kind: delegates_to from: orch.lead to: dev.impl完整边类型说明可参考 docs/reference/edge-types.md。Startup 启动块三层叠加的文件与动作Startup 块可以出现在Rig / Pod / Member 三层按叠加模型合并下发。files启动文件字段必填说明path✅安全相对路径delivery_hint❌默认autoauto自动选择 /guidance_merge合并进CLAUDE.md或AGENTS.md/skill_install装进技能目录 /send_text直接发送文本required❌默认true文件投递失败是否让启动失败applies_on❌默认两者都含fresh_start/restore的子集actions启动动作字段必填说明type✅slash_command/send_text/startup_proof⚠️shell明确不支持value✅要发送的文本或authenticated/nonephase❌默认after_filesafter_files文件投递后/after_ready就绪检查通过后idempotent✅是否可安全重放——必填字段非幂等动作不得把restore放进applies_onapplies_on❌默认[fresh_start, restore]官方演示里infraPod 就用它自动启动 UI 服务见 demo/rig.yamlstartup: actions: - type: send_text value: npm run dev -- --host 127.0.0.1 phase: after_ready idempotent: true applies_on: [fresh_start]Services 与 Continuity两块可选增强services托管服务v1 仅支持kind: compose。核心字段compose_file必填、project_name须匹配[a-z0-9][a-z0-9_-]*、down_policyleave_running/down/down_and_volumes默认down、wait_for每个目标恰好选url/tcp/service三者之一健康检查不过会阻止 Agent 启动、surfaces纯展示元数据不会被执行、checkpoints快照/恢复时的导出导入 shell 命令{{artifacts_dir}}会被替换。continuity_policy连续性策略Pod 级配置控制压缩compaction后的恢复行为continuity_policy: enabled: true sync_triggers: [pre_compaction, pre_shutdown] # 还可加 manual、milestone artifacts: session_log: true restore_brief: true quiz: false restore_protocol: peer_driven: true # 由同伴驱动恢复 verify_via_quiz: false # 是否用问答验证恢复高频校验报错速查rig spec validate和rig up都会强制执行 26 条校验规则完整清单见 docs/reference/rig-spec.md#validation-rules-summary最常遇到的是❌ Pod/Member ID 含点号或重复 → 规则 3、5❌ 终端节点三件套不完整 → 规则 7❌ Pod 内部边写了dev.impl→ 规则 11❌ 跨 Pod 边两端同 Pod → 规则 12❌idempotent漏写 → 规则 24它是最容易被忽略的必填项❌ 路径出现..或绝对路径culture_file、启动文件、compose_file→ 规则 14从自带模板抄作业与其从零写不如直接读仓库内置的 5 个官方 spec 当模板Spec位置特点product-teampackages/daemon/specs/rigs/preview/product-team/rig.yaml7 成员完整产品小队含 orchestration/dev/reviewimplementation-pairpackages/daemon/specs/rigs/launch/implementation-pair/rig.yaml最简双人组impl qaadversarial-reviewpackages/daemon/specs/rigs/focused/adversarial-review/rig.yaml对抗式评审research-teampackages/daemon/specs/rigs/focused/research-team/rig.yaml研究团队secrets-managerpackages/daemon/specs/rigs/launch/secrets-manager/rig.yaml唯一带 Docker Compose 服务的模板Vault一句话总结RigSpec v0.2 的心智模型就三层——Rig定身份和全局上下文Pod划有界团队并挂连续性策略Member定座位agent_ref runtime cwd再用Edges把关系连线。抓住Pod 内裸 ID、跨 Pod 全限定 ID和idempotent必填这两个坑你基本可以读懂并写出任何合法的 RigSpec。【免费下载链接】openrigMulti-agent harness that runs Claude Code and Codex together as one system项目地址: https://gitcode.com/GitHub_Trending/op/openrig创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考