用途:设计或审计智能体在启动后如何变得有用,包括 AGENTS.md 叠加、角色文件、技能、rig 规范、工作流规范、启动清单、refocus 消息,以及当前 rig 上下文检索与 profile 表面。其核心观点是:多数协调失败不是工具失败,而是上下文失败;智能体需要知道自身角色、运行模式、协调约定、边界和当前产品意图。
适用场景:编写新智能体的启动文件(role / culture / startup-context);刷新因过期指导而运行的席位;审计智能体是否获得当前运行模式;设计 orchestrator → next-agent 上下文传递形态;为构建 OpenRig 的 rig 建立启动映射。不适用:通过 Agent Starter 创建智能体(其 manifest 自带启动上下文);从数据包重建心智模型(属于 session-compaction-and-restore);将可复用启动内容作为技能发布。
任务范围启动:运行 rig whoami --json,再解析 project.yaml -> mission.yaml -> active slice.yaml -> 选定组件或 wave map -> addressed context。完整查找与优先级规则见 docs/reference/product-journey-sdlc.md#resolve-the-selected-path(安装位置:$OPENRIG_HOME/reference/product-journey-sdlc.md#resolve-the-selected-path)。读取本任务所需的选中地址与来源;profile 中可用的技能是能力,不是必读清单。启动文件是地址映射,不是普遍阅读强制要求。
启动文件与技能的区别:启动文件(role.md、CULTURE.md、startup/context.md)是 rig 特定、角色特定的身份,说明智能体是谁、在做什么、团队如何运作;技能是可复用 SOP / 方法论 / 知识,说明如何做某事,可跨 rig 迁移。不要把技能内容放进启动文件,也不要把身份内容放进技能。7 层加性启动模型(agent / profile / rig / culture / pod / member / operator)负责分层。
限制与失败模式:新智能体可能从旧 rig 规范启动而错过当前运行模式;对文件的修改不会传播到运行中的会话,需要配合文化推广;启动文件可能变成堆砌场而失去指向权威来源的作用;orchestrator 传递实现指令时可能丢失产品意图。编辑文件本身不证明已运行的席位采纳,需要授权刷新或下次启动观察。来源可信度排序:rig whoami > target rigspec > bounded latest transcript > full transcript > touched-files > restore-summary.json。缺失选中上下文应作为具名缺口解决。