SuperAPI AI 工具集

argent-create-flow

通用与其它

查看项目

更新于 10-16 09:30

技能介绍

用途:创建、录制、编辑、回放和修复 Argent 可复用流程 YAML 文件,流程保存在 .argent/flows/<name>.yaml。适用需要重复执行同一设备路径、配置性能分析等场景。

主要能力与流程类型:支持 e2e 类型(首个非 echo: 或 script: 步骤为 launch:,由流程控制进程启动)和 fragment 类型(无前置 launch,需声明精确的 executionPrerequisite)。创建工作流包括开始录制、一次验证一个步骤、完成、打磨(polish)、审计与回放。

录制与回放规则:录制第一次走查,须在首次启动或应用内操作前开始录制,不得重建已排练的路径。使用语义目标,优先严格的 id,其次稳定文本或无障碍标签;离屏元素用 scroll-to。每个屏幕变化都要证明,录制仅目标身份检查,打磨时接 await: { idle: true }。仅在执行行为上打磨,不改变步骤含义。最终 YAML 需端到端回放;普通流程需一次不中断完整通过,argent-qa-flows 需连续两次通过。回放失败时检查首个偏差,修正最小合理单元,审计并回放整个流程;两次修正未成则停止,不得削弱要求通过的检查。

设备限制:流程在物理 iPhone 上运行(iOS 列表中的 kind 为 device 条目),但回放不会自动绑定设备,即使没有启动模拟器也不会;需传入手机 udid 作为 device(CLI --device),且仅连接的手机会运行。pinch/rotate 步骤在硬件上会失败,同现场工具。硬件上的流程树即 describe 树,具有相同的 id 和 role,没有 UIView 层级。

其他限制:仅在用户要求时使用脚本;录到捕获警告、原始坐标、不可用树、时机错误转换、覆盖层或回放失败时,参考 Reliability and recovery。在重复三次或更多交互前,应告知用户并开始录制,已完成的路径无法追溯录制。资料未提供收费、价格、平台支持以外的信息。