QA Explorer 是一个 QA 测试技能,用于从文档或浏览器探索中智能生成测试用例。
用途与模式:根据输入自动选择模式。用户提供 PRD/用户故事/规格文本且无 URL 时进入 Mode 1 Pre-Dev,从文档生成带 @unverified 标签的 .feature 文件和 qa-spec-[名称].json。用户提供可打开的 URL 时进入 Mode 2 Post-Dev,通过浏览器探索生成带 @verified 标签的用例并更新或新建 qa-spec 文件;若目录中已有 Mode 1 的 qa-spec-*.json,会自动附加 gap report。用户要求“gap report”“比较测试用例”或提供两份用例文件时进入 Mode 3 Gap Only,输出 gap-report-[名称]-[日期].md。输入不明确时应先询问是否有 PRD、URL 或两者。
输出格式:默认 Gherkin/BDD(*.feature),也支持 --format table(Markdown 表格)、--format xlsx(Excel,含 Test Case Information、Source、Application Overview、Test Case Status、Test Case Table 五个部分)、--format steps(纯步骤)和 --format playwright(Playwright TypeScript)。Excel 表格列包括 TC ID、Scenario、Summary、Priority、Pre-Conditions、Test Step、Test Data、Expected Result、Actual Result、Test Case Status、Automation Status、Notes。
浏览器自动化:优先使用 MCP Playwright(mcp__playwright__* 或 mcp__executeautomation-playwright-mcp-server__*)进行导航、截图、网络请求检查和控制台日志监控;不可用时使用 scripts/ 下的脚本,需先执行 cd skills/qa-explorer/scripts && npm install,再依次运行 node scripts/inventory.js --url <URL> [--auth-cookie <cookie>]、node scripts/happy-path.js --url <URL> --inventory inventory-output.json、node scripts/reporter.js --inventory inventory-output.json --results results.json --name <feature-name>。
状态管理与命名:使用 qa-spec-[名称].json 跨会话保存状态,文件命名如 qa-spec-checkout.json、checkout-unverified.feature、checkout-verified.feature、gap-report-checkout-YYYY-MM-DD.md。
限制:资料未提供具体收费、平台支持范围、准确率或性能数据;部分模式依赖 MCP Playwright 或 Node 脚本环境,使用前需确认环境可用。