用途:这是一个内部 Oz 子代理编排手册(skill),适用于在 Oz 云代理环境中由其他代理派生出的、运行在 Claude Code 里的子代理。
主要能力与工作方式:子代理应聚焦给定的子任务,产出 lead 代理可直接应用的清晰结果,例如补丁、命令或简明结论。应尽量减少与用户的直接交互,如需澄清只提一个聚焦问题,更倾向于做出合理假设并说明。输出保持简洁、可操作,包含确切文件路径、待运行命令和具体下一步。
环境限制:子代理运行在隔离的远程环境,而非用户本机;除非被明确提供,不应假设能访问未同步的本地文件、分支、终端或凭据。如需用户本地的产物,请让 lead 代理发送相关细节或文件。
身份信息:代理 ID 为 OZ_RUN_ID 的值,父代理 ID 与 lead 代理 ID 为 OZ_PARENT_RUN_ID 的值,Oz CLI 命令为 OZ_CLI 的值。若 OZ_RUN_ID、OZ_PARENT_RUN_ID 或 OZ_CLI 缺失,应视为阻塞项,不要猜测,等待更正后的上下文再尝试联系父代理。
消息传递:必须使用 "$OZ_CLI" run message send --sender-run-id "$OZ_RUN_ID" --to "$OZ_PARENT_RUN_ID" --subject "<subject>" --body "<body>" 保持 lead 代理知情,不应静默完成工作。发消息不是终止动作,每次发送后必须检查收件箱。在开始、完成、被阻塞三个里程碑都要向 OZ_PARENT_RUN_ID 发送消息。可用命令还包括 "$OZ_CLI" run message list "$OZ_RUN_ID" --unread --limit 25 列出收件箱、"$OZ_CLI" run message read "$MESSAGE_ID" 读取正文,以及 mark-delivered 或 delivered 确认送达。
轮询要求:不要假设框架会自动推送父代理消息。发送消息后应立即运行 list 检查未读;若有未读则读取并按最新父指令继续。只有在检查收件箱后才可决定继续、等待或停止。还应在开始新工作块前、暂停后、决定是否继续等待父输入前、以及声称完成或待命前轮询收件箱。若等待回复,应自行以适度节奏轮询而非紧密循环,收到回复后读取并恢复工作;在发送后或空闲前的收件箱检查显示没有需要处理的未读父消息之前,绝不要声称自己在待命。
适用场景:Oz 云端 Claude Code 子代理与 lead 代理之间的任务协作、状态同步与结果交付。其余如具体收费、价格等信息暂未提供。