SuperAPI AI 工具集

debug-replay

测试与质量

查看项目

更新于 10-15 19:56

技能介绍

Debug Replay 用于在 Amplitude Session Replay 中调查 bug:先找到错误发生的会话,再提取交互时间线,整理为可供工程师照做的编号复现步骤,衔接“用户报了一个 bug”与“具体如何复现”。

主要能力与用法:技能依赖三个 Amplitude Session Replay 工具并按顺序使用。Amplitude:get_amp_session_replay_info 的 action: "search" 按错误、特定用户、时间窗口等筛选会话并返回元数据与回放链接;action: "list" 在已有用户/设备 ID 时做简单分页列出,返回 device_id/session_id 格式的回放 ID;action: "events" 将指定回放解码为导航、点击、输入、滚动等交互时间线,传入前面的 sessionReplayId。辅助工具包括 Amplitude:use_amplitude_cohorts 的 action: "find"(按邮箱、用户 ID 等查找用户)、分类目录读取能力(用于确认合法的事件与事件属性名称,不猜测名称)、以及 Amplitude:use_amp_flags 的 action: "list_deployments"(核对错误是否与近期部署相关)。

流程为:解析 bug 报告,提取错误标识、用户标识、时间窗口(默认最近 7 天)和产品区域;报告模糊时先问一个澄清问题;调用 get_amplitude_context 获取上下文,并用分类目录确认错误事件名;查找错误会话;对每个会话提取交互时间线(标准会话 event_limit 用 500,4 个以上会话用 200);对比多个时间线,找出错误之前的共同前缀,归并无关动作得到最小复现路径;检查部署上下文;最后输出工程可用的 bug 报告,含 bug 摘要、环境上下文、编号复现步骤、错误上下文、会话证据(回放链接与置信度:3 个以上会话为 High,2 个为 Medium,仅 1 个为 Low)及可选观察。

限制与边界:项目可能未开启自动捕获或错误使用自定义事件名;用户可能查不到;部分会话可能没有 rrweb 回放数据(回放关闭、广告拦截等),需跳过并说明;仅 1 个会话时只能作为未验证步骤并标低置信度;错误间歇出现时可按多条路径分别呈现;action: "events" 返回的是 DOM 节点 ID 而非元素名,需按位置与页面上下文描述交互。暂未提供该技能的收费、价格与平台信息。