SuperAPI AI 工具集

bug-reproduction-brief

测试与质量

查看项目

更新于 10-15 21:52

技能介绍

用途:当缺陷报告不完整、间歇出现、依赖特定环境或混入假设原因时,用此技能先证明最小可观察的失败,再进入诊断或修复。

主要能力与流程:

  1. 记录观察到的失败:精确错误、错误输出、时间戳、受影响路由或命令、最小已知输入;保留相关日志但去除密钥与个人数据;二手描述标注为未验证。
  2. 识别环境:仅记录可检查的事实,如仓库与提交、运行时与包管理器版本、操作系统或容器、依赖锁文件、相关功能开关、目标是本地/测试/预发/生产。不得猜测凭据或生产配置。
  3. 区分预期与实际:分别写出两条可观察陈述,预期:[可观察结果];实际:[可观察结果,含状态或错误]。不要把疑似原因写进任一条。
  4. 缩减复现:从报告路径出发,逐一移除无关数据、服务和步骤,保留仍失败的最小夹具;若失败消失,恢复最后移除的条件并记录。优先使用隔离测试、最小脚本或最小安全请求,而非在生产环境复现。
  5. 证明可重复性:在安全前提下至少运行最小复现两次,记录命令与输出;若为间歇性,报告观察到的频率与持续时间,不要称为确定性。
  6. 修复前停止:已验证的复现即为交付物。构建简报时不要修改实现代码,以免破坏证据或混淆诊断与修复。

输出格式:Bug Reproduction Brief,包含目标与提交、环境、预期、实际、最小步骤、最小夹具、是否复现(是/否/间歇)、证据、未知项、下一个可安全测试的假设。

安全边界:不得仅为复现而更改生产数据;不得发布密钥、客户记录或私有源码;不得仅凭相关性声称根因;优先只读或可逆的发现方式;验证复现后停止,诊断与修复属于独立工作流。

示例提示:对失败的结账测试使用 Bug Reproduction Brief 技能,先不要修复,将其缩减为最小安全失败夹具,并报告确切命令证据、预期结果、实际结果与剩余未知项。

限制:资料未提供具体安装命令、平台支持范围、收费方式或性能数据。