SuperAPI AI 工具集

replay-user-flows

通用与其它

查看项目

更新于 10-15 22:33

技能介绍

用途:把一次点击探索过的用户旅程保存为可确定性重放的回归检查,回放过程不引入模型,也无需编写测试代码。探索应用找出旅程是昂贵环节,用模型反复驱动会重复付出该成本;Reticle 流程只付一次,旅程以语义锚点保存后确定性回放。

前提:项目需已接入 Reticle。未接入时执行 RETICLE_INSTALL_SOURCE=npx_skill npx @reticlehq/server@latest init,再使用 install-and-verify 技能。

录制:会话结束时驱动过程会自动保存为流程,写入 .reticle/flows/,提交后仓库内任意智能体均可回放。步骤只有在声明了后果时才保留该后果,例如 reticle_act_and_wait({ sessionId, ref, action: "click", until: { kind: "signal", name: "task:created" } }) 会作为测试回放;裸 reticle_act 只保存点击、无可验证内容。可用 reticle_record 与 reticle_flow_save(经 reticle_run { tool, args } 调用)显式命名流程;RETICLE_ADVERTISE_ALL_TOOLS=1 可直接暴露这些工具。可用 reticle_annotate 标注业务结果(intent、success-state)。元素无 testid 时自动锚定组件与源码位置,保留 testid 的重构仍可回放通过。

回放:reticle_verify({ sessionId, action: "change", files: [...] }) 回放覆盖这些文件的流程;reticle_flow_replay 经 reticle_run 调用可回放指定流程。状态有 ok、drift(锚点未命中,可读 decision.nextAction 获取文件:行与最近存活锚点)、error(流程文件缺失或无效,或步骤运行时失败)。drift 时 reticle_verify { action: "heal" } 可提出最近匹配重绑。

全量校验:reticle_verify({ sessionId, action: "flows" }) 一次调用回放全部已保存流程,仅失败项带详情。按变更范围回放:reticle_verify({ sessionId, action: "change", since: "HEAD~1" }) 只回放覆盖已改文件的流程。reticle_domain 可查看覆盖率(asserted、presenceOnly、assertionFree)与缺口。

限制与建议:只运行一次的旅程用 reticle_act_and_wait 驱动即可,不必录制;应录制定义产品的关键流程。回放只报告实际发生情况,drift 不等于通过;若应用确实损坏却通过 heal 使其变绿,会使整套流程失去价值。完整流程参考见 curl https://docs.reticle.sh/flows.md,索引见 curl https://docs.reticle.sh/llms.txt。