预发环境复现缺陷包
docs.x.ai/grok-bot/use-cases · docs.x.ai/grok-bot/computer-and-apps · docs.x.ai/grok-bot/approvals-security-and-privacy
官方 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(若你的流程需要人工确认再回帖)。
步骤
阅读这份缺陷报告,在预发环境用全新测试账号复现。
交付:精确步骤、期望与实际行为、截图、浏览器与系统信息、相关控制台或网络笔记;可能的话给最小用例。
不要使用生产客户数据。不要改生产配置。
贴报告或 issue 链接(只读连接器优先)。用五要素补全:结果=复现包;来源=该 issue + 预发 URL;约束=不用生产数据、不改生产;交付=步骤/期望实际/截图/环境;停止点=回帖或改状态前先问你。
需要登录时用 Take over 或安全请求。 你自己完成登录与二次验证,确认已登录页加载后再让它继续。不要把密码或验证码发在普通聊天里。
检查复现包是否含证据与环境字段。 打开成果卡里的截图与笔记,按下方清单勾选;缺一项就让它补同一份产物,不要另起互不相干的副本。
跑稳后可存技能;事件触发示例见 Routines「needs repro」。宽匹配「每条新消息」不要用。
结果:把 ISSUE-1234 变成可复核的复现包。
来源:@GitHub 上的该 issue;预发环境 URL 见描述;只用我提供的测试账号。
约束:不用生产客户数据;不改生产配置;不在 issue 下自动评论。
交付物:编号步骤、期望 vs 实际、截图、浏览器/OS/预发标识、控制台或网络笔记、可能的最小用例。
停下来等我的节点:任何写回 issue、任何通知客户、任何生产变更。
交付物检查清单
- [ ] 步骤编号完整,他人可跟做(不是「再点一下那个按钮」这种含糊说法)
- [ ] 期望 vs 实际分开写
- [ ] 截图或录屏位置说明(哪一步、哪张图)
- [ ] 浏览器 / OS / 预发环境标识
- [ ] 相关控制台报错或网络请求笔记(没有就写「未观察到」)
- [ ] 可能的最小用例或最小复现数据说明
- [ ] 明确未使用生产客户数据
- [ ] 未改生产配置、未自动回帖(除非你另行批准)
做成例程
当 Slack/工单渠道出现「needs repro」类窄规则时,可事件触发(见官方 Routines 示例)。注意:
- 匹配规则要窄:标签、关键词、指定频道,而不是「每条新消息」。
- 例程六项确认:归属 Bot、时间表或事件源、输入、预期结果、审批边界、源缺失时怎么办。
- 新建或改完先 Test run——它会真的开网页、调工具;用安全输入测。
- 对外同步 issue 评论前先审批(若你的流程需要)。

失败时怎么办
- 登不进预发:Take over 自己登;检查是否过期的 SSO / VPN;不要让它在登录页死循环烧用量。
- 「复现不了」但报告很明确:要求它列出已尝试的步骤与环境差异,而不是只回「无法复现」;差在浏览器、账号角色还是数据夹具,要写清楚。
- 截图是空白或错页:让它在关键步骤前后各截一次,并在步骤里引用图片;成果卡点开核对。
- 例程误触发刷屏:立刻禁用例程,收紧匹配规则,看运行历史;宽事件匹配是常见坑,见新手坑点。
- 不小心用了疑似生产数据:停止任务;按团队流程上报;不要把数据再贴回公开 issue。
你要检查什么
- 是否误用生产数据。
- 凭证是否出现在对话明文。
- 复现步骤是否他人可跟做——最好自己按步骤点一遍。
- 期望与实际是否真的分开,而不是混在一段里。
- 有没有在未批准时写回 issue 或通知客户。
- 技能 / 例程里是否仍写着「不用生产客户数据」。
审批边界
禁止写生产、禁止导出真实客户 PII。对外同步 issue 评论前先审批(若你的流程需要)。
测试账号的密码与二次验证不要出现在普通聊天。审批只管这一次提议的动作;已经打开的预发页面不会因为你点 Deny 而自动登出——敏感会话结束时自己收一下。
相关
- Routines — 事件触发与 Test run。
- 云电脑与接管 — Take over 登录。
- 码初 · 工程搭档
- 场景:Cloud Agent 开带预览的 PR — 复现之后再谈修。
- 安全与审批
复现日期
2026-10-20 按官方 use-cases 整理。
出处说明
官方 Use cases · Bug Reproduction。起手提示词为官方英文示例的中文改写,未添加虚构的产品按钮名。未编造分享链接或截图。