SuperAPI AI 工具集

verify-ui-change-in-cloud

测试与质量

查看项目

更新于 10-16 08:18

技能介绍

用途

该技能用于在完成任何面向用户的客户端改动后,自动触发验证流程。它适用于非沙箱环境和本地环境,覆盖范围不限于视觉或界面改动,还包括启动行为、配置处理、迁移流程以及其他客户端逻辑。

主要能力

通过启动具备计算机使用能力的云端智能体来验证改动。云端智能体在全新环境中克隆仓库并运行应用,从而观察改动在运行时的实际表现。

使用方式

  1. 推送改动:云端智能体在全新环境中克隆仓库,因此改动必须推送到分支,以便云端智能体能够访问。

  2. 检测仓库:在启动云端智能体之前,检测当前所在仓库。检查 Git 远程 URL:

git remote get-url origin

确认远程 URL 包含 warpdotdev/warp。如果不包含,则警告用户该技能仅支持 warp 仓库并停止。warp 开发环境的环境 ID 为 SVhg783GBFQHk1OfdPfFU9。

  1. 启动云端智能体:使用 run_agents 工具启动远程云端智能体。单子批次(agent_run_configs 中一个条目)是有效的。
  • summary:简短的陈述性说明,例如“Spawning a cloud agent with computer use to verify the UI change.”
  • base_prompt:包含读取并遵循 test-warp-ui 技能的指令,后接验证任务
  • remote.environment_id:SVhg783GBFQHk1OfdPfFU9
  • remote.computer_use_enabled:true
  • agent_run_configs:单个条目,name 设置为简短显示名称,例如“verify-ui-change”。每个智能体的提示可以为空,因为 base_prompt 已覆盖任务。

test-warp-ui 技能已捆绑,因此云端智能体自动拥有它。在 base_prompt 中告知智能体按名称调用它(例如“Read and follow the test-warp-ui skill.”)。

  1. 编写有效的提示:提示应告知云端智能体:
  • 要测试哪个元素、流程或行为
  • 需要哪些硬编码或模拟
  • 启动前需要预置哪些文件系统或应用状态(例如创建目录、写入配置文件)
  • 需要报告哪些具体观察结果

示例提示:

I changed the settings dialog header to use a larger font and blue color. Hardcode the settings dialog to open on launch, then describe the header text, font size relative to other text, and color.

I added a migration that symlinks config from ~/.warp into ~/.warp-preview on first launch. The migration is gated on Channel::Preview. Before building, hardcode the migration to run regardless of channel by removing the channel check. Also create a fake ~/.warp directory with test files. After launching Warp, verify the symlinks were created in ~/.warp-preview.

硬编码以到达被测代码路径:云端智能体使用 cargo run 构建 Warp,这可能与改动的确切运行时条件不匹配(例如不同的渠道、缺少功能标志、缺少前置条件)。此时,指示云端智能体临时硬编码代码,以便构建能够执行需要测试的路径。常见示例:

  • 受门控的代码路径:如果改动位于渠道检查、功能标志或实验之后,告知智能体在构建前移除或绕过门控。
  • 预先存在的状态:如果改动依赖于干净环境中不存在的文件系统状态(例如先前安装的配置目录),告知智能体在启动前创建它。
  • 启动行为:如果改动影响仅在首次启动或迁移时发生的内容,确保智能体设置触发它的前置条件。

在提示中明确说明要硬编码什么以及为什么——云端智能体不会自行推断这一点。

  1. 展示云端智能体链接:无需额外的展示步骤——Warp 客户端会自动显示云端智能体运行。

适用场景

适用于 warpdotdev/warp 仓库中任何影响用户所见或所体验的客户端改动,包括界面、启动行为、配置处理、迁移流程等。

限制

该技能仅支持 warp 仓库。必须在非沙箱环境和本地环境中使用。改动必须推送到分支。