跳至主要内容
SCENARIO · 工程

预发环境复现缺陷包

阅读约 7 分钟核对日期 2026-10-20

官方 Bug Reproduction 角色:把报告变成可复核的复现包。连接 issue 跟踪、预发环境、浏览器与网络工具。它的价值不在「替你修 bug」,而在于把含糊的「不好用」变成别人能跟做的步骤、期望与实际、截图和环境字段。

官方起手示例(意译)是:阅读缺陷报告,在预发用全新测试账号复现;交付精确步骤、期望与实际、截图、浏览器与系统信息、相关控制台或网络笔记,可能的话给最小用例;不要使用生产客户数据。凭证走安全交接,不要贴进普通聊天。

适用

  • 有预发 / 测试环境与测试账号,且账号权限与生产隔离。
  • 需要步骤、期望/实际、截图与环境信息,而不是一句「我复现了」。
  • 缺陷报告已经写在 issue 跟踪或文档里,Bot 能只读访问。
  • 你愿意先人工验收一份复现包,再考虑「needs repro」类事件例程。

什么时候不该用

  • 没有预发,只能进生产——本场景明确禁止用生产客户数据;没有隔离环境就先别上自动化。
  • 报告本身只有「打不开」三个字、没有任何环境线索,而你又不肯补第一轮澄清——Bot 会在猜测里烧用量。
  • 你其实要的是修复并开 PR——那是 Cloud Agent 或 云电脑 CLI 的活;复现包先完成,再谈修。
  • 凭证只能通过聊天明文交接——停下来,改用官方说的安全交接 / 接管登录。

准备

  • Bot:可用 码初 或自建「复现」职责 Bot。描述里写死:「只用预发与测试账号;不用生产客户数据;不改生产配置。」
  • 连接器:issue 跟踪(GitHub Issues / 其它 tracker)、必要时浏览器。装好后每次任务用 @ 挂载。
  • 测试凭证走安全交接,不要贴进普通聊天。需要登录时准备好 Take over。
  • Auto Review:对外同步 issue 评论、改生产看板之类动作保留 Ask first(若你的流程需要人工确认再回帖)。

步骤

官方风格首单(改写为中文)
阅读这份缺陷报告,在预发环境用全新测试账号复现。
交付:精确步骤、期望与实际行为、截图、浏览器与系统信息、相关控制台或网络笔记;可能的话给最小用例。
不要使用生产客户数据。不要改生产配置。
  1. 贴报告或 issue 链接(只读连接器优先)。用五要素补全:结果=复现包;来源=该 issue + 预发 URL;约束=不用生产数据、不改生产;交付=步骤/期望实际/截图/环境;停止点=回帖或改状态前先问你。

  2. 需要登录时用 Take over 或安全请求。 你自己完成登录与二次验证,确认已登录页加载后再让它继续。不要把密码或验证码发在普通聊天里。

  3. 检查复现包是否含证据与环境字段。 打开成果卡里的截图与笔记,按下方清单勾选;缺一项就让它补同一份产物,不要另起互不相干的副本。

缺陷复现包交付示意

  1. 跑稳后可存技能;事件触发示例见 Routines「needs repro」。宽匹配「每条新消息」不要用。
五要素版复现单
结果:把 ISSUE-1234 变成可复核的复现包。
来源:@GitHub 上的该 issue;预发环境 URL 见描述;只用我提供的测试账号。
约束:不用生产客户数据;不改生产配置;不在 issue 下自动评论。
交付物:编号步骤、期望 vs 实际、截图、浏览器/OS/预发标识、控制台或网络笔记、可能的最小用例。
停下来等我的节点:任何写回 issue、任何通知客户、任何生产变更。

交付物检查清单

  • [ ] 步骤编号完整,他人可跟做(不是「再点一下那个按钮」这种含糊说法)
  • [ ] 期望 vs 实际分开写
  • [ ] 截图或录屏位置说明(哪一步、哪张图)
  • [ ] 浏览器 / OS / 预发环境标识
  • [ ] 相关控制台报错或网络请求笔记(没有就写「未观察到」)
  • [ ] 可能的最小用例或最小复现数据说明
  • [ ] 明确未使用生产客户数据
  • [ ] 未改生产配置、未自动回帖(除非你另行批准)

做成例程

当 Slack/工单渠道出现「needs repro」类窄规则时,可事件触发(见官方 Routines 示例)。注意:

  • 匹配规则要窄:标签、关键词、指定频道,而不是「每条新消息」。
  • 例程六项确认:归属 Bot、时间表或事件源、输入、预期结果、审批边界、源缺失时怎么办。
  • 新建或改完先 Test run——它会真的开网页、调工具;用安全输入测。
  • 对外同步 issue 评论前先审批(若你的流程需要)。

写例程 → Test run → 上线

失败时怎么办

  • 登不进预发:Take over 自己登;检查是否过期的 SSO / VPN;不要让它在登录页死循环烧用量。
  • 「复现不了」但报告很明确:要求它列出已尝试的步骤与环境差异,而不是只回「无法复现」;差在浏览器、账号角色还是数据夹具,要写清楚。
  • 截图是空白或错页:让它在关键步骤前后各截一次,并在步骤里引用图片;成果卡点开核对。
  • 例程误触发刷屏:立刻禁用例程,收紧匹配规则,看运行历史;宽事件匹配是常见坑,见新手坑点。
  • 不小心用了疑似生产数据:停止任务;按团队流程上报;不要把数据再贴回公开 issue。

你要检查什么

  • 是否误用生产数据。
  • 凭证是否出现在对话明文。
  • 复现步骤是否他人可跟做——最好自己按步骤点一遍。
  • 期望与实际是否真的分开,而不是混在一段里。
  • 有没有在未批准时写回 issue 或通知客户。
  • 技能 / 例程里是否仍写着「不用生产客户数据」。

审批边界

审批

禁止写生产、禁止导出真实客户 PII。对外同步 issue 评论前先审批(若你的流程需要)。

测试账号的密码与二次验证不要出现在普通聊天。审批只管这一次提议的动作;已经打开的预发页面不会因为你点 Deny 而自动登出——敏感会话结束时自己收一下。

相关

复现日期

2026-10-20 按官方 use-cases 整理。

出处说明

官方 Use cases · Bug Reproduction。起手提示词为官方英文示例的中文改写,未添加虚构的产品按钮名。未编造分享链接或截图。