agent-native 是一个面向并行代理编排的技能,核心用途是把调用方选定的独立任务派发给并行 worker 或子代理,并对会话进行启动与观察,同时避免写入冲突。它只负责“启动与观察”,不验证输出,也不成为 AgentOps 的生命周期权威:适配器不能选择 AgentOps 语义、签发约束性裁决,或把工厂完成当作交付或验证证明。编排方决定派发什么、何时派发。
使用方式与主要能力:
- 启动前校验整批任务。每个 packet 需要有选定的执行器、packet 身份、全部传递性影响,以及在独立隔离中的规范工作区相对写入范围;任一 packet 无效则不启动任何任务,部分启动不被接受。
- 比较规范范围:解析符号链接、规范化路径并做大小写不敏感比较,避免别名隐藏冲突;仅做词法检查无法证明符号链接或运行时隔离。
- 派发只执行一次,保留每个 packet 身份与结果对应;执行器错误是结果,不是重试触发条件。
- 启动时先捕获可观察的 runtime、session 与上下文身份,并通过调用方拥有的原生通道记录派发关联;请求的 ID 不等于观察到的 ID。
- 通过原生等待或状态通知观察;在重启、替换或 nudged 之前先捕获可观察状态,静默或急躁本身不足以作为重启理由。
- 新授权的后续工作使用运行时有文档的 follow-up 或 resume 操作,消息操作只排队文本。
角色包括 Orchestrator、Implementer、Validator、Scribe,以及有界的 Reader 与 Writer;Reader 返回最多 350 行的行引用要点,Writer 按规格落地一个文件并返回收据。NTM、原生进程、Agent Mail、Gas City 及一次性无头 runner(codex-exec、claude-exec、agy-native)是可替换适配器,仅在调用方选定该执行形态时使用。判断默认使用作者模型家族的新上下文;跨模型 Validate、混合 Council 与对决式模型视角需调用方明确选择。角色请求声明权限,但只有原生运行时/操作系统文件系统与出口控制能强制执行。
限制:批量契约参考实现 scripts/swarm/dispatch_once.py 需要 AgentOps 源码检出,不随已安装技能捆绑;已安装使用通过选定的原生运行时派发。它拒绝非空 write_scope.exclude,因为其证明无法支持排除项。批量模式不选择积压工作、不创建队列、不集成变更。提供者重试、重连、空闲状态和失败都只作为运行时事实,不进入 Plan、Candidate 或裁决状态。每个 packet 结果包含 packet_id、执行器、观察到的会话、参与证据、终止状态、结果与缺口,缺失信息如实标为 unknown。