browser-acceptancelisted
Install: claude install-skill ayouaiyouwei-arch/claude_pm_workflows
> 🔧 项目无关骨架版 · 项目专属配置见 PROJECT-PROFILE.md
# Skill · browser-acceptance
> 一句话定位:针对一条 `case_id`,用 cursor-ide-browser MCP 做**手工辅助验收**(探索性 / 修复前后人工对照 / 5 态人工复核),把结论落到 `evidence/<版本>/<case_id>/浏览器辅助验收记录.md`,并通过 `执行清单.csv` 留痕。
## 触发条件
- 用户明确要求「手工验收 / 浏览器辅助跑一下 xxx 用例」
- Playwright 跑批失败后人工复核(确认是真 bug 还是用例问题)
- 探索性测试 / 单条问题快速复现
- 修复后人工对照
- `automation_type=manual` 用例的执行
## 输入
| 输入 | 是否必填 | 示例 |
|---|---|---|
| `case_id` | ✅ | `TC-SEC-001` |
| 当前生效基线 | ✅ | `B1.0.x` |
| 验收账号角色 | ✅ | `dispatcher` |
| 期望相位 | ✅ | `before` / `after` / `both` |
| 是否需要 SQL 校验 | 可选 | 是 / 否 |
## 工具
- **cursor-ide-browser MCP**:`browser_navigate` / `browser_snapshot` / `browser_click` / `browser_fill` / `browser_take_screenshot` / `browser_network_requests` / `browser_tabs` / `browser_lock`
- **关联技能**:调 `capture-test-evidence` 抓证据、调 `log-diff-entry` 登记新差异
## 步骤
1. **基线锁定 + 用例校验**
- 读 `baseline/01-基线版本登记表.md` 拿当前 B 版本号
- 在 `test/test-cases/<模块>.csv` 中确认 `case_id` 真实存在并读取 `steps` / `expected` / `five_states` / `evidence_required`
2. **环境校验**
- 真实数据模式(非 Mock;开关见 PROJECT-PROFILE.md § 六)
- 目标 URL 可访问(前端地址见 § 六)
- 环境变量 `QA_<ROLE>_USER` / `QA_<ROLE>_PASSWORD` 已设置
3. **浏览器准备**
- `browser_tabs` 看现有标签
- 若已有标签 → 先 `browser_lock {action:lock}` 锁定;否则 `browser_navigate` 后再锁
4. **登录**
- `browser_navigate` 到 `/login`
- `browser_snapshot` 拿表单 ref
- `browser_fill` 用环境变量填账号密码(**禁止明文粘贴**)
- `browser_click` 提交
5. **执行 CSV `steps`**
- 按 `steps` 字段顺序逐步操作
- 每一步前 `browser_snapshot` 防 ref