source-command-e2e-audit
当用户要求运行迁移后的 source command e2e-audit 时使用此技能。
命令模板
E2E 审计:基于浏览器的产品验证
打开浏览器,走查产品,发现业务逻辑与 UX 问题。
这不是关于代码正确性——代码可能“正确”,但业务逻辑可能是错的。
为什么需要 E2E 审计?
静态代码分析无法捕捉:
用户选择“Hong Kong”却看到中国的“五險三金”
日历对 US 用户显示以周一为每周开始
货币换算使用过期汇率
税务计算在特定区域出错
权限设置不具备业务合理性
关联功能之间的数据不一致
流程
- 启动浏览器
mcp__playwright__browser_navigate - 打开产品 URL mcp__playwright__browser_snapshot - 获取当前页面状态
- 走查用户旅程
认证:
注册流程(所有字段、校验、错误消息)
登录流程(记住我、忘记密码)
登出与会话处理
核心功能:
主要用户工作流端到端
次要功能
设置与配置
个人资料管理
边缘情况:
空状态
错误状态
边界值(最小/最大)
无效输入
面向公众的页面:
落地页/主页——价值主张是否清晰?CTA 是否可用?
定价页——是否准确?链接是否可用?
文档/帮助——是否可访问?搜索是否可用?
社交分享——OG 预览是否正确?链接是否可用?
- 测试业务逻辑
区域/区域设置一致性:
更改用户区域 → 验证所有相关数据是否更新
货币、日期格式、语言、法律要求
区域特定功能的显示/隐藏是否正确
数据一致性:
关联字段保持同步
计算结果符合业务正确性
聚合数据与明细记录一致
业务规则:
权限是否正确执行
工作流状态是否有效
业务约束是否被遵守
- 记录问题
针对发现的每个问题:
mcp__playwright__browser_take_screenshot # 捕获证据
问题类别
业务逻辑错误
数据与业务预期不符
规则在特定上下文中应用错误
跨功能数据不一致
UX 问题
用户流程令人困惑
缺少反馈
错误消息不清晰
无障碍问题
视觉问题
布局破损
响应式问题
样式不一致
现代 UI 模式(需测试)
能否内联编辑,还是必须打开模态框/页面?
能否拖放排序?
破坏性操作后是否有撤销?
是自动保存还是需要手动保存?
键盘快捷键是否可用(⌘K、⌘S 等)?
加载状态是否平滑(骨架屏)还是突兀(旋转指示器)?
过渡是动画还是瞬间跳转?
输入在有用处是否提供搜索/自动补全?
浏览器工具参考
mcp__playwright__browser_navigate - 转到 URL mcp__playwright__browser_snapshot - 获取页面状态(频繁使用) mcp__playwright__browser_click - 点击元素 mcp__playwright__browser_fill_form - 填写表单 mcp__playwright__browser_type - 输入文本 mcp__playwright__browser_select_option - 选择下拉项 mcp__playwright__browser_take_screenshot - 捕获证据 mcp__playwright__browser_press_key - 键盘输入
输出
发现的问题
类型 描述 严重程度 截图
1 业务逻辑 HK 用户看到 CN 保险 高 screenshot_1.png
2 UX 提交时无加载状态 中 screenshot_2.png
创建 GitHub 问题
gh issue create --title "[E2E] Brief description" --body "..." --label "e2e-audit"
思维方式
代码正确 ≠ 业务正确——始终验证业务逻辑
像真实用户一样思考,而不是开发者
测试不顺利的路径
质疑每一个假设
如果感觉不对,它很可能就是不对