qa

/qa - 自动化测试与修复

对 Web 应用进行系统性 QA 测试，找到 bug 后修复代码并原子提交，最后重新验证。生成带证据的结构化报告。

使用方式

/qa                              # 标准 QA 测试
/qa https://example.com          # 测试指定 URL
/qa --quick                      # 快速冒烟测试（30秒）
/qa --exhaustive                 # 穷举测试（包含 low/cosmetic）

测试层级

层级	覆盖范围
Quick	Critical + High 严重级别
Standard	+ Medium 严重级别（默认）
Exhaustive	+ Low / Cosmetic 严重级别

---

Phase 1: 初始化

检测项目运行时：

[ -f package.json ] && echo "RUNTIME:node"
[ -f Gemfile ] && echo "RUNTIME:ruby"
[ -f requirements.txt ] || [ -f pyproject.toml ] && echo "RUNTIME:python"
[ -f go.mod ] && echo "RUNTIME:go"
[ -f Cargo.toml ] && echo "RUNTIME:rust"

检测测试框架：

ls jest.config.* vitest.config.* playwright.config.* .rspec pytest.ini pyproject.toml phpunit.xml 2>/dev/null
ls -d test/ tests/ spec/ __tests__/ cypress/ e2e/ 2>/dev/null

创建输出目录：

mkdir -p .claude-studio/qa-reports/screenshots

---

Phase 2: 目标 URL

优先从用户请求中解析 URL：

• 用户提供了 URL → 直接使用
• 用户未提供 URL → 检查本地端口（localhost:3000/4000/8080）
• 无法检测 → 询问用户

检查 git 分支（diff-aware 模式）：

git branch --show-current
git diff main...HEAD --name-only
git log main..HEAD --oneline

如果提供了 URL 但在特性分支上，优先测试受分支变更影响的页面。

---

Phase 3: 探索

Orient - 应用地图

1. 访问目标 URL
2. 获取导航结构（links 或 snapshot -i）
3. 检查控制台错误
4. 检测框架：
   • HTML 含 __next → Next.js
   • 含 csrf-token → Rails
   • 含 wp-content → WordPress
   • 客户端路由无页面重载 → SPA

Explore - 系统性遍历

每个页面：

1. 截图存档（screenshot）
2. 检查控制台错误（console --errors）
3. 点击所有按钮/链接，验证响应
4. 填写表单并提交（空提交、无效数据、边界值）
5. 检查导航路径
6. 检查各状态（空状态、加载状态、错误状态、溢出状态）
7. 响应式检查（移动端 viewport）

优先级： 核心功能（首页、仪表盘、结账、搜索）多花时间，次要页面（关于页、条款页）少花时间。

Quick 模式

仅访问首页 + 顶部 5 个导航目标。检查：页面加载？控制台错误？可见的失效链接？无详细问题文档。

---

Phase 4: 记录

每个问题立即记录，不要批量。

截图证据要求：

• 交互式 bug：操作前截图 → 执行操作 → 结果截图
• 静态 bug（布局问题、错字）：单张带标注截图

使用 Read 工具展示截图给用户。

---

Phase 5: 健康评分

计算各类别分数（0-100），取加权平均。

评分规则

类别	权重
Console	15%
Links	10%
Visual	10%
Functional	20%
UX	15%
Performance	10%
Content	5%
Accessibility	15%