该技能面向在 openrig 仓库克隆中修改 OpenRig 自身源码的场景,实质是“地图的地图”,用于定位某个行为由哪个包或文件负责、应运行哪些测试。文中提醒各文档地图可能不完整或过时,地图与代码冲突时以代码为准,修正地图属于受欢迎的贡献。
用途与导航:先区分所处环境。若在 OpenRig 内运行,存在两个 OpenRig——运行当前会话的已安装版本(由 rig --version 与 rig daemon status 描述)和正在修改的检出(由 git rev-parse HEAD 描述)。重启已安装守护进程不会运行你的检出,且停止它会停掉其上运行的智能体(包括你自己);应使用仓库自带测试框架(启动私有守护进程与 tmux 服务器)验证改动,而非重启所依赖的守护进程。
主要能力:提供文档索引,回答 OpenRig 已能做什么(能力地图)、rig 命令是否已存在(rig --help)、问题是否已知(docs/reference/help.md 的已知问题)、功能是否已规划(ROADMAP.md)、包结构与请求路径及扩展点(ARCHITECTURE.md)、是否触及高风险区域(docs/as-built/arteries.md)、推送前运行什么及各测试层能证明什么(docs/as-built/test-layers.md)、命令确切行为、子系统深入文档、用户参考、随附技能索引与贡献指南(CONTRIBUTING.md)。
必要用法:短版测试为 npm run build、npm run lint、npm test;完整阶梯见 test-layers.md,含 stub-agent 场景,以脚本化智能体运行真实 CLI、守护进程、tmux 与 SQLite,无模型成本。场景运行器启动独立守护进程与 tmux 服务器并丢弃当前会话的 TMUX 与守护进程变量,不会影响会话所用守护进程。stub 只能证明 OpenRig 自身管线,不能证明 Claude Code 或 Codex 的行为,需说明实际验证对象。
限制与约束:文档可能过时,仅在实际核对后才更新 last-verified-against-source 标记;arteries.md 按设计不完整,未列入不代表安全。若差异触及动脉(消息投递、启动与恢复、队列、rig 身份、技能投影、进程观测、迁移、恢复),需阅读该行依赖与历史回归、在 PR 中描述下游影响、增加或扩展 stub-agent 场景。评审偏好减少摩擦或让状态更真实的改动;添加行为前先问具备正确指令与现有命令的智能体能否完成;每 PR 一件事;新增拒绝、提示或必需步骤需在 CONTRIBUTING.md 给出具体受损案例。缺失的地图值得开 issue。