解决什么问题 · Problem
走查报告有两大通病:要么只有「感觉不对」没有证据,要么把缺测试数据、缺权限的情况一律夸大成产品 bug。
这件 skill 用严格分类把噪音滤掉:Product bug / Bug candidate / Fixture blocked / Automation limitation / Manual retest 五类各归其位,缺 fixture 绝不充数为 bug。每个步骤必须先写 START 行、后写 PASS / FAIL / TIMEOUT / SKIP / BLOCKED 终态行;PASS 必须有正向断言——「没抛错」不等于「通过」,空白页照样能把点击跑成功。三类读者(工程师、复测人、请求方)各拿各的文档,互不淹没。
怎么用 · How to use
在目标项目根目录(SKILL.md 中的真实命令):
python3 /path/to/browser-walkthrough-reporter/scripts/\
scaffold_browser_walkthrough.py --project-root .生成 doc/browser-walkthrough-plan.md、scripts/browser-walkthrough.mjs 与报告目录;把选择器、路由、fixture 适配到真实应用后分 scope(config / usage / full / diagnostic)执行,截图按 <模块>_<时间戳>_<状态>.png 归档。要提 GitHub issue 时先用 prepare_github_issues.py 出英文草稿,triage 复核后经确认才创建。
适用场景 · When to use
- dev / staging 环境的 UI 回归巡检
- 验证每个页面 / 路由都能真实渲染(含 Electron / WebView 宿主的正确入口选择)
- 把走查发现整理成工程师可直接开修的缺陷单
- 按标准流程把确认的 bug 提交为英文 GitHub issue
开源仓库 github.com/Octo-o-o-o/browser-walkthrough-reporter · GitHub 账号 Octo-o-o-o
去获取 →