SuperAPI AI 工具集

cross-platform-cloud-verification

部署与运维

查看项目

更新于 10-16 08:20

技能介绍

用途

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。
  • 汇总结果而不隐藏缺口:等待所有子任务后报告跨平台验证状态、本地门禁、各平台结果、未验证项、证据和结论。

使用方式

  1. 完成本地验证门禁,确认包含变更的精确提交或分支可被云端代理检出。
  2. 读取相关验证技能,构建一份共享验证流程。
  3. 执行 oz-dev runner list --output-format json 发现运行器。
  4. 根据变更证据推断受影响的 OS 与架构维度。
  5. 选择最小运行器矩阵,记录选择理由并列出因无可用运行器而省略的相关平台。
  6. 为每个选定运行器构造仅做验证的子提示。
  7. 使用 run_agents 启动,remote.runner_id 为运行器 UID;不同 UID 的运行器需要分开调用。
  8. 通过子消息和生命周期事件协调,最多对明显瞬态基础设施故障重试一次。
  9. 等待所有子任务后汇总,使用 passed、failed 或 incomplete 作为结论。

适用场景

  • 变更可能影响多个操作系统或架构,需要在云端确认行为。
  • 本地验证已通过,需要最后一道跨平台验证层。
  • 需要以最小成本覆盖受影响的平台,而不是全平台扇出。

限制

  • 不定义产品特定的验证流程,只决定在哪里运行该流程。
  • 不应作为探索性的第一步,也不应替代本地失败诊断。
  • 不得让子任务实现修复或推送代码。
  • 运行器发现失败时应报告阻塞,而不是编造运行器矩阵。
  • 缺少运行器不阻塞在可用相关平台上的有用验证。
  • 具体收费、价格、平台支持范围等事实资料中未提供。