菜单
Self-healing for the generated test suite. Use when previously-green Playwright tests are failing, the user says "my tests broke", "fix the tests", "/qa-heal", or after a UI refactor breaks selectors. Classifies each failure (real bug vs test drift) and repairs the drift — never papers over real bugs.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Full QA audit orchestrator. Use when the user asks to "test my app", "run a full QA audit", "test everything", or invokes /qa-audit. Discovers what kind of application this is, selects the relevant QA agents (ui-inspector, api-sentinel, security-scout, perf-guardian, data-validator, regression-watcher), runs them, and merges their reports into one master QA report.
Onboard the QA toolkit onto any project. Use on first contact with a new codebase, when the user says "set up QA", "qa init", "/qa-init", or when any QA agent finds no qa-profile.md. Studies the project deeply and writes the persistent QA profile that every other agent reads first — the toolkit's long-term memory for this project.
Wire the QA suite into CI. Use when the user wants tests running automatically on every PR or on a schedule: "add this to CI", "run tests on every push", "/qa-ci". Generates GitHub Actions workflows for the generated Playwright suite and (optionally) scheduled full audits.
Compare two QA audit runs and report what improved, what regressed, and what persists. Use when the user asks "did it improve since last time?", "compare audits", "QA trend", or invokes /qa-trend. Requires at least two timestamped runs under qa-reports/runs/.
Audit web pages for WCAG 2.1 compliance. Use when the user asks about accessibility, a11y, WCAG, screen readers, or contrast issues.
Generate and execute API contract tests from OpenAPI/Swagger specs. Use when the user wants contract tests or schema validation for an API.
基于 SOC 职业分类
| name | qa-heal |
| description | Self-healing for the generated test suite. Use when previously-green Playwright tests are failing, the user says "my tests broke", "fix the tests", "/qa-heal", or after a UI refactor breaks selectors. Classifies each failure (real bug vs test drift) and repairs the drift — never papers over real bugs. |
Prime directive: a failing test is a signal; healing must never silence a real bug. You repair tests that broke because the app legitimately changed. You report (not "fix") tests that broke because the app is broken.
npx playwright test --reporter=json (or the project's runner). Collect every
failure with its error, trace, and the spec source.
Four drift types plus the one that matters most:
| Type | Signal | Action |
|---|---|---|
| Selector drift | Locator not found, but the page snapshot shows the same element with new role/name/structure | Update locator to match current UI, prefer role/label |
| Flow drift | Step order changed (new onboarding screen, moved button, extra confirmation dialog) | Re-walk the flow in the browser, update steps to the new legitimate path |
| Data drift | Fixture/test data stale (deleted user, expired token, changed enum) | Regenerate fixture or create data via API in setup |
| Environment drift | Port changed, server slower to start, new env var required | Fix playwright.config webServer / env setup |
| REAL BUG | The app behavior genuinely violates the assertion's intent | DO NOT touch the test. Report it. |
Classification method (intent-based, not guesswork): open the app at the
failing step (Playwright MCP or --headed trace), take a snapshot, and ask
"can the user still accomplish this test's INTENT?" If yes → drift, heal it.
If no → real bug, report it.
When ambiguous, treat as a real bug and ask the user — a wrongly-healed test is worse than a noisy one.
Append to qa-reports/qa-profile.md → Quirks & Learnings: what drifted and
why (e.g. "2026-06-12 qa-heal: signup flow gained email-verification step —
flows touching signup must handle it"). Future audits and test generation
read this and don't trip on the same change.
HEAL: X healed (Y selector, Z flow, ...), W real bugs found, V flaky