用途
该技能用于在完成任何面向用户的客户端改动后,自动触发验证流程。它适用于非沙箱环境和本地环境,覆盖范围不限于视觉或界面改动,还包括启动行为、配置处理、迁移流程以及其他客户端逻辑。
主要能力
通过启动具备计算机使用能力的云端智能体来验证改动。云端智能体在全新环境中克隆仓库并运行应用,从而观察改动在运行时的实际表现。
使用方式
-
推送改动:云端智能体在全新环境中克隆仓库,因此改动必须推送到分支,以便云端智能体能够访问。
-
检测仓库:在启动云端智能体之前,检测当前所在仓库。检查 Git 远程 URL:
git remote get-url origin
确认远程 URL 包含 warpdotdev/warp。如果不包含,则警告用户该技能仅支持 warp 仓库并停止。warp 开发环境的环境 ID 为 SVhg783GBFQHk1OfdPfFU9。
- 启动云端智能体:使用 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.”)。
- 编写有效的提示:提示应告知云端智能体:
- 要测试哪个元素、流程或行为
- 需要哪些硬编码或模拟
- 启动前需要预置哪些文件系统或应用状态(例如创建目录、写入配置文件)
- 需要报告哪些具体观察结果
示例提示:
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,这可能与改动的确切运行时条件不匹配(例如不同的渠道、缺少功能标志、缺少前置条件)。此时,指示云端智能体临时硬编码代码,以便构建能够执行需要测试的路径。常见示例:
- 受门控的代码路径:如果改动位于渠道检查、功能标志或实验之后,告知智能体在构建前移除或绕过门控。
- 预先存在的状态:如果改动依赖于干净环境中不存在的文件系统状态(例如先前安装的配置目录),告知智能体在启动前创建它。
- 启动行为:如果改动影响仅在首次启动或迁移时发生的内容,确保智能体设置触发它的前置条件。
在提示中明确说明要硬编码什么以及为什么——云端智能体不会自行推断这一点。
- 展示云端智能体链接:无需额外的展示步骤——Warp 客户端会自动显示云端智能体运行。
适用场景
适用于 warpdotdev/warp 仓库中任何影响用户所见或所体验的客户端改动,包括界面、启动行为、配置处理、迁移流程等。
限制
该技能仅支持 warp 仓库。必须在非沙箱环境和本地环境中使用。改动必须推送到分支。