Browser Smoke Testing
用途
- 把“前端已经改完”变成“关键页面和核心路径在浏览器里确实可用”。
- 适合页面、交互、静态资源发布、关键用户路径和上线前回归确认场景。
默认做法
- 先锁定 smoke 范围:目标环境、入口 URL、关键页面、核心用户路径、预期可见结果和不在本轮覆盖的内容。
- 明确运行方式:优先复用当前环境可用的真实浏览器能力,例如 Playwright CLI、agent-browser 或项目已有 E2E harness;不要为了 ad-hoc smoke 临时搭一整套新测试框架。
- 对动态页面,先等页面完成首屏渲染、关键请求返回或交互状态稳定,再判断是否通过;不要在骨架屏、占位态或旧缓存状态下过早下结论。
- 优先验证高风险路径:页面可打开、核心导航可达、主操作可完成、关键异常态可触发、静态资源无明显 404/缓存错配。
- 用截图、控制台错误、失败步骤和环境说明留下证据,并把结论回交
/team-review、/team-release或角色 handoff。
触发信号
- 需求包含页面、组件、路由、表单、导航、权限跳转或静态资源变更。
/team-release需要关键页面 smoke 范围和发布后验证证据。- 代码层测试通过了,但仍需确认真实浏览器中的渲染、交互、缓存或网络行为。
- QA 或实现角色需要快速确认“关键路径能跑通”而不是一次性补完整 E2E 套件。
配套约束
- 先遵循 frontend-quality-gates 中的 smoke 范围、回滚触发条件和前端证据要求。
- 需要补齐页面范围、产品类型和 UI 约束时,先看 frontend-governance。
- 若 smoke 目的是发布验证或回滚判断,直接连同
/team-release、release-plan.md 和相关发布治理 runbook 一起使用。 - 需要系统化留痕、失败归因或多轮确认时,分别接 systematic-debugging 和
/verify。 - 如果被环境、登录、测试数据或后端依赖阻塞,明确记录 blocker 和前置条件,不把“环境没起来”误写成产品缺陷。
Source: hashgraph-online/awesome-codex-plugins → plugins/Colin4k1024/tsp/skills/browser-smoke-testing/SKILL.md