用途
Cross-platform cloud verification 是一个编排型技能,用于在本地较便宜的检查通过之后,跨可用的操作系统与架构运行器执行成本可控的云端验证。它负责运行器发现、平台选择、子任务编排和结果汇总,但不定义产品特定的验证流程。
由于跨平台执行会消耗远程计算资源和额度,该技能被定位为最后一道验证层,而不是探索性的第一步。
主要能力
- 建立本地验证门禁:先检查变更、运行相关本地构建、聚焦测试、lint、类型检查或手动验证,修复确定性的本地失败后再启动云端运行。
- 将测试设计委托给验证技能:读取定义受影响表面验证方式的技能,提取安装与认证要求、命令或交互、预期观察与通过标准、所需截图/录制/日志/文本捕获、平台特定注意事项,并构建一份共享验证流程。
- 在执行时发现运行器:通过
oz-dev runner list --output-format json列出运行器,使用返回的元数据而非硬编码名称或 ID。 - 推断受影响的平台维度:根据 diff、仓库配置、报告的 bug 和验证指导,判断变更是否对 OS 敏感或对架构敏感。
- 选择最小运行器矩阵:只选择受影响的 OS,每个受影响 OS 选一个代表性运行器,仅在架构敏感时增加另一架构,默认不添加未受影响的对照平台。
- 构造仅做验证的子提示:包含仓库、分支、精确提交、所选运行器、验证技能与流程、前置条件、命令、预期结果与所需证据,并禁止子任务修复或推送代码。
- 使用 run_agents 启动:保持子任务 ID、消息、生命周期事件和产物属于父编排流程,同一仓库环境,
remote.runner_id设为发现的运行器 UID。 - 汇总结果而不隐藏缺口:等待所有子任务后报告跨平台验证状态、本地门禁、各平台结果、未验证项、证据和结论。
使用方式
- 完成本地验证门禁,确认包含变更的精确提交或分支可被云端代理检出。
- 读取相关验证技能,构建一份共享验证流程。
- 执行
oz-dev runner list --output-format json发现运行器。 - 根据变更证据推断受影响的 OS 与架构维度。
- 选择最小运行器矩阵,记录选择理由并列出因无可用运行器而省略的相关平台。
- 为每个选定运行器构造仅做验证的子提示。
- 使用 run_agents 启动,
remote.runner_id为运行器 UID;不同 UID 的运行器需要分开调用。 - 通过子消息和生命周期事件协调,最多对明显瞬态基础设施故障重试一次。
- 等待所有子任务后汇总,使用 passed、failed 或 incomplete 作为结论。
适用场景
- 变更可能影响多个操作系统或架构,需要在云端确认行为。
- 本地验证已通过,需要最后一道跨平台验证层。
- 需要以最小成本覆盖受影响的平台,而不是全平台扇出。
限制
- 不定义产品特定的验证流程,只决定在哪里运行该流程。
- 不应作为探索性的第一步,也不应替代本地失败诊断。
- 不得让子任务实现修复或推送代码。
- 运行器发现失败时应报告阻塞,而不是编造运行器矩阵。
- 缺少运行器不阻塞在可用相关平台上的有用验证。
- 具体收费、价格、平台支持范围等事实资料中未提供。