rig 包是一种打包后可分享的产物,能够实例化一套有明确主张的 OpenRig 拓扑与工作流。它可能包含 rig 规格、agent 规格、工作流规格、启动文件、技能或技能引用、运行模式声明、验证期望以及辅助片段。可分享产物范围比包更广:规格、包、技能、工作流与扩展都可分享;包是“加载这套拓扑与工作方式”的打包形式。
适用场景:从已验证的实验模式编写包;安装包(rig bundle install <path>);安装前检查包(rig bundle inspect <path>);判断包与扩展的边界(包声明拓扑与工作流,扩展添加行为);审计包的可移植性,即它能否在干净的 OpenRig 环境中工作,而非只在作者机器上可用。
不适用场景:一次性、不会复用的拓扑,仅用规格即可;意图是添加运行时行为(命令、视图、仪表盘),应使用 extension-and-user-workspace;想把工作流作为守护进程特性发布,包是进入守护进程前的路径。
包与扩展的边界:包声明 rig 形态与工作流,例如一个 Velocity Team 包;扩展为用户工作区或运行时添加行为,例如自定义命令、视图或仪表盘。二者都可分享,但结构不同,不要混淆。
常见失败模式:包只在操作者机器上可用,因为路径、提供方或凭据是隐式的,包必须对干净 OpenRig 环境自描述;包包含过多本地状态,变成备份归档而非可复用产物;包声明了拓扑却遗漏验证期望或工作流模式,仅拓扑无法说明“如宣传般工作”的含义;用户安装前无法检查包会创建什么,rig bundle inspect 必须能在无副作用的情况下展示将要创建的内容。
验证标准:把包安装到干净的 OpenRig 环境;实例化;验证预期的席位与工作流模式;运行小型冒烟验证,确认拓扑行为符合宣传。
包路径通向产品:本地试用模式 → 带清单、参数化与验证期望的包 → 他人安装到干净 OpenRig → 以有主张的工作流发布而无需成为守护进程特性 → 若足够可靠,将部分能力升级进核心守护进程。这也是 OpenRig 发布有主张工作流而不必将每个工作流都做成守护进程特性的方式。相关技能包括 extension-and-user-workspace、specification-system、agent-starters 与 openrig-user。