qa-team

QA Agent 团队

Codex 兼容性

在 Codex 中运行此技能时，执行前请转换仅适用于 Claude Code 的原语：AskUserQuestion -> chat/request_user_input，TodoWrite -> update_plan，在可用且允许时，Task/TaskCreate/TeamCreate/SendMessage -> spawn_agent/send_input/wait_agent，以及 EnterPlanMode/ExitPlanMode -> 简洁的聊天计划并明确征求批准。 将 Read/Write/Edit/Bash/WebSearch/WebFetch 解析为 Codex 文件/终端/网页工具；除非任务明确针对 Claude Code，否则将 ~/.claude/... 路径映射到 ~/.agents/... 或 ~/.codex/...。

Cursor 兼容性

在 Cursor Agent 中运行此技能时，执行前请转换仅适用于 Claude Code 的原语：AskUserQuestion -> AskQuestion；TodoWrite -> Cursor TodoWrite 或等效的检查清单；在允许时，Task/TaskCreate/TeamCreate/SendMessage/多 Agent 流程 -> Cursor Task（子 Agent）、并行 Tasks 或 run_in_background（TeamCreate/SendMessage 可能没有完全对应的功能）；EnterPlanMode/ExitPlanMode -> Plan mode（SwitchMode / CreatePlan）并明确征求用户批准。 通过 Cursor Composer 或 Agent 的等效工具解析 Read/Write/Edit/StrReplace/Bash/网页/搜索/MCP。写作 mcp__server__tool 的 MCP 名称通常映射到带有已配置服务标识符的 call_mcp_tool。除非任务明确针对 Claude Code，否则将 ~/.claude/... 映射到 ~/.cursor/skills/、.cursor/skills/ 和 .cursor/rules/。

由 5 个专业视角的成员和 1 名团队负责人组成的全面 QA 验证团队。

团队组成

角色	模型	Agent/技能基础	视角
qa-lead	opus	quality-engineer	协调、汇总、最终把关
visual-tester	opus	gui-phd-*	布局、响应式设计、渲染
functional-tester	opus	feature-validator（增强版）	用户流程 + 影响传播
hig-tester	opus	web-design-guidelines	Apple HIG、WCAG AA+
edge-case-tester	opus	quality-engineer	长文本、100+ 条记录、溢出
ux-tester	opus	ph-quality-gate	暗色背景上的深色内容、缺少反馈、不一致

激活流程

第 1 步：准备工作

1. 确保开发服务 / 应用正在运行（如不确定，请询问用户）
2. mkdir -p claudedocs/qa/screenshots
3. 从 package.json 检测平台（或使用 --platform 标志）：
   • 有 "electron" → Electron
   • 有 expo / app.json → iOS/Expo
   • 有 .xcodeproj / Package.swift macOS 目标 → macOS
   • 默认 → Web

第 2 步：创建 Agent 团队

使用 TeamCreate 工具，设置 team_name 为 "qa-team"，description 为 "QA verification team"。

不要自行执行 QA 工作。只创建团队，让队友开展工作。

然后使用 Task 工具创建 6 位队友，并设置 team_name: "qa-team"：

qa-lead（subagent_type: "general-purpose"）：

• 阅读 ~/.claude/agents/quality-engineer.md
• 创建包含 8 项任务的任务列表（参见下方依赖关系图）
• 等待全部 5 份报告，然后汇总到 claudedocs/qa/qa-summary.md
• 根据评分标准应用最终综合门槛

visual-tester（subagent_type: "general-purpose"）：

• 阅读 ~/.claude/agents/gui-phd-web-electron.md（或根据平台选择 gui-phd-mobile/gui-phd-macos）
• 执行 RALPH 协议截图验证，阈值为 95%
• 报告保存至 claudedocs/qa/qa-visual-integrity.md

functional-tester（subagent_type: "general-purpose"）：

• 阅读 ~/.claude/agents/feature-validator.md
• 执行 4 阶段影响传播协议
• 报告保存至 claudedocs/qa/qa-functional.md

hig-tester（subagent_type: "general-purpose"）：

• 阅读 CLAUDE.md 中的 Design Policies 部分
• 检查 Typography、Tap Areas、Colors、Spacing、Motion、Corner Radius
• 报告保存至 claudedocs/qa/qa-hig-compliance.md

edge-case-tester（subagent_type: "general-purpose"）：

• 阅读 ~/.claude/agents/quality-engineer.md
• 测试空文本/长文本、100+ 条记录、边界值和溢出
• 报告保存至 claudedocs/qa/qa-edge-cases.md
• blockedBy：functional-tester 任务

ux-tester（subagent_type: "general-purpose"）：

• 应用 PH Quality Gate 的 Visual 维度（V1-V5，满分 100）
• 报告保存至 claudedocs/qa/qa-ux-sensibility.md
• blockedBy：visual-tester 任务

第 3 步：按平台选择工具

平台	主要工具
Web	playwright-cli（open --headed、snapshot、screenshot、click、fill）
Electron	/qa-electron skill（连接到 Electron CDP 的 playwright-cli）
iOS/Expo	mcp__ios-simulator__*
macOS	mcp__mac-mcp-server__*

在进行任何浏览器交互之前（Web 或 Electron）：调用 /dnd 加载拖放验证协议。基于引用的 drag 在 dnd-kit 等类似库中会报告错误的成功状态，因此请预先加载该协议，即使尚不确定是否涉及 DnD。

第 4 步：进入委派模式

创建所有队友后，告知用户按 Shift+Tab 进入委派模式。 负责人应进行协调——你不应亲自编写任何 QA 报告。

第 5 步：监控并汇总

• qa-lead 等待 claudedocs/qa/ 中的全部 5 份报告
• 使用评分标准中的权重计算综合得分
• 生成 claudedocs/qa/qa-summary.md 并给出最终结论

第 6 步：最终质量门槛

组件	权重	PASS 阈值
Visual	25%	三项标准均达到 95%
Functional	30%	通过率 95%，P0=0
HIG	15%	综合得分 80/100
Edge Cases	15%	崩溃数为 0
UX Sensibility	15%	PH Visual 75/100，严重问题为 0

>= 85：通过 / 65-84：有条件通过 / < 65：未通过

任务依赖关系图

Task 1: [qa-lead] Platform Detection & Test Plan
  ├── Task 2: [visual-tester]     Visual Integrity         (parallel)
  ├── Task 3: [functional-tester] Functional Correctness   (parallel)
  ├── Task 4: [hig-tester]        Apple HIG Compliance     (parallel)
  ├── Task 5: [edge-case-tester]  Edge Cases               (blockedBy: 3)
  ├── Task 6: [ux-tester]         UX Sensibility           (blockedBy: 2)
  ├── Task 7: [qa-lead]           Report Aggregation       (blockedBy: 2,3,4,5,6)
  └── Task 8: [qa-lead]           Final Quality Gate       (blockedBy: 7)

输出结构

claudedocs/qa/
├── qa-test-plan.md              # Platform + test plan
├── qa-visual-integrity.md       # Visual report
├── qa-functional.md             # Functional report (with impact verification)
├── qa-hig-compliance.md         # HIG report
├── qa-edge-cases.md             # Edge case report
├── qa-ux-sensibility.md         # UX sensibility report
├── qa-summary.md                # Aggregated final verdict
└── screenshots/
    ├── visual_*.png
    ├── func_*.png / func_*_impact_*.png
    ├── hig_*.png
    ├── edge_*.png
    └── ux_*.png

标志

标志	效果
--platform <type>	强制指定平台（跳过自动检测）
--skip <perspective>	跳过一个或多个评估维度
--quick	仅执行视觉和功能测试（队友数量从 6 人减为 3 人）

参考资料

• references/qa-scoring-rubric.md — 各评估维度的详细评分标准
• workflows/web-workflow.md — Web 平台测试工作流
• workflows/electron-workflow.md — Electron 测试工作流
• workflows/mobile-workflow.md — iOS/Expo 测试工作流
• workflows/macos-workflow.md — macOS 测试工作流

完成标准

满足以下条件时，QA 会话即告完成：

• 全部 5 份个人报告均已生成且包含结论
• 所有报告均附有截图作为依据
• 已在 qa-summary.md 中计算综合得分
• 已给出最终结论（通过 / 有条件通过 / 未通过）