用途
OpenRig 面向 mvschwarz/openrig 项目，是一个采用 Apache-2.0 许可的 OpenRig CLI、守护进程、TUI 以及持久化多智能体 rig 系统，支持 Claude Code、Codex 和 Pi。本技能是 OpenRig 的操作指南，适用于对 OpenRig 进行适配性检查（fit-check）、安装、升级、配置、预检、运营、恢复或故障排查，也涉及 @openrig/cli、rig 规格与 bundle、kernel/operator、tmux/Herdr 视图、seat、队列、快照及已登记的远程主机。
主要能力与工作方式
技能要求先“冻结操作面”：记录单一模式（orient、install、configure、operate、recover 或 build）和单一本地或已登记远程目标；将提供方 CLI、凭据、桌面终端、网络访问和远程主机视为相互独立的授权边界。原生 Windows 不受支持，需使用文档给出的 WSL2 路线；OPENRIG_HOME 仅用于选择 OpenRig 实例状态，不涉及提供方配置。
在任何安装、设置、守护进程、TUI、rig、提供方或发送操作之前，先运行离线预检辅助脚本，它不会启动 OpenRig 或执行 shell 命令：
python3 .agent-skills/openrig/scripts/preflight.py --json python3 .agent-skills/openrig/scripts/preflight.py --repo /path/to/openrig --expect-commit <FULL_SHA> --json
已安装的技能使用：python3 "$SKILLS_ROOT/openrig/scripts/preflight.py" --json。该脚本报告主机/工具路径，并在提供 --repo 时给出有界 Git 身份与公开检出形态。发现 Node 路径并不证明版本满足要求，需参照参考资料中的运行时规则。
所有副作用都应先经过门槛控制：本地命令流程从只读的 --help、--json、--plan、status、process 和 capture 命令开始；安装器的 --dry-run 仍会获取并管道执行远程 shell 代码，不构成只读或安全边界。网络访问与远程代码执行需要单独明确批准，随后安装、提供方配置或凭据、权限策略、bundle 安装、守护进程/kernel 启动、实时发送、远程写入和拆除也需分别批准。不得复制密钥、令牌、恢复令牌或完整环境转储。
操作时按问题类型查阅对应参考资料分支：安装/设置或平台问题查 Install and platform；守护进程、kernel、seat、终端或就绪状态查 Runtime surfaces；RigSpec、.rigbundle、库、目标或主机拓扑查 RigSpec and topology；捕获、队列、发送、恢复、拆除或健康状态不确定时查 Operate and recover；应使用其中固定的命令与引用，不替换为无引用的变体；并将 daemon-up、kernel-started、seat-started 与 message-rendered 作为不同证据区分。
效果需窄范围验证：审批前检查每个计划/就绪结果；超时意味着投递未确认，重试前先 capture；扇形发送需逐一检查每个接收方；修复具体 spec、bundle 或路径错误后，先重跑窄检查再重装或重建活动 rig。
示例路径
只读检出与主机检查：python3 .agent-skills/openrig/scripts/preflight.py --repo /path/to/openrig --expect-commit <FULL_SHA> --json；使用 rig daemon status、rig status、rig ps 或 rig capture 前，先阅读 Runtime surfaces；该辅助脚本不会启动守护进程、TUI、提供方或 rig。
已批准的计划路径：阅读 RigSpec and topology，本地验证与审计，仅在守护进程批准后运行由守护进程支持的 spec 预检，并在启动批准前用 --plan --json 预览 rig up。
现有 rig 恢复：阅读 Operate and recover，先检查进程与捕获证据，再为快照拆除和 --existing 恢复分别申请批准。
最佳实践
优先使用固定版本、输出 JSON、dry-run 和 plan 模式，并保留其输出作为证据；将守护进程、kernel、seat、spec 有效性、提供方认证与工作区正确性分开判断；优先有界任务，对不确定的发送先用 capture 验证再重试；将 GitHub bundle 和远程主机视为不可信输入，远程写入前确认传输、认证与身份；仅在单独明确批准后使用 --force 与 --delete；保持辅助脚本离线且诚实——路径存在不等于运行时激活或模型质量。
限制
资料未提供具体安装命令、Node 版本数值、收费方式或价格、平台范围细节（除原生 Windows 不支持、需走 WSL2 外）以及实际效果数据，这些暂未提供。操作须以资料引用的固定命令和审计来源为准，不应自行替换为未引用的变体。