aif-qa-check

Executes QA test cases in human-guided or automated-agent mode and records pass/fail results.

1.1k|96|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/lee-to/ai-factory --skill aif-qa-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aif-qa-check
Source: https://github.com/lee-to/ai-factory/tree/main/skills/aif-qa-check
Command: npx skills add https://github.com/lee-to/ai-factory --skill aif-qa-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Running QA test cases manually without structure leads to lost progress, inconsistent results, and no audit trail. This Skill executes the test cases produced by /aif-qa one at a time, records pass/fail/blocked outcomes in a persistent qa-check.md artifact, and keeps results valid by tracking source, revision, and worktree digests.

Core Features & Use Cases

  • Dual execution modes: Run cases interactively with a human answering whether each case works, or let an agent verify cases automatically through browser automation, CLI commands, test runners, API calls, or file inspection.
  • Stale-result detection: Per-case and whole-file digests plus tested-revision and worktree tracking automatically invalidate outdated results when code or test cases change.
  • Cross-run QA memory: Maintains reusable agent-context.md and agent-history.md files so future automated QA runs reuse environment facts, selectors, and lessons without repeating mistakes.
  • Safety guardrails: Requires explicit authorization before destructive or production-side-effect actions and redacts credentials and tokens from all recorded evidence.
  • Use Case: After generating test cases for a new authentication feature, run the skill in agent mode to automatically execute backend tests and browser checks, then switch to human mode for the remaining UI cases, ending with a complete qa-check.md report.

Quick Start

Run the QA check skill in agent mode for the current branch to execute the test cases and record the results in qa-check.md.

Frequently Asked Questions about aif-qa-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run QA test cases automatically with an AI agent?

Invoke the skill in agent mode with an optional branch argument. The agent classifies each case by execution surface, then verifies it through browser automation, CLI commands, existing test runners, API calls, or file inspection, recording evidence in qa-check.md.

How do I run manual QA test cases one at a time?

Use human mode, which shows exactly one test case at a time with its steps and expected result, then asks whether it works. Your answer is recorded as Passed or Failed with your comment, and progress is saved after every case.

What happens to QA results when the code changes after testing?

The skill tracks the tested commit revision, a worktree digest, and per-case source digests. When any of these change, prior results are marked Stale and unchecked, requiring retest so outdated passes are never counted as current.

Does automated QA work without browser automation tools?

Browser-dependent cases are marked Blocked if neither in-app Browser nor Playwright MCP is available, while CLI, backend-test, API, and file-inspection cases still execute. You can enable a browser capability or run the blocked cases later in human mode.

Can the agent run destructive commands during automated QA?

No. Destructive, irreversible, or production-side-effect actions such as database mutations, deployments, or deletions require explicit per-case user authorization. If authorization is denied, the case is marked Blocked without executing the risky action.

What are the limitations of automated-agent QA mode?

Agent mode cannot invent credentials, URLs, or fixtures, and cases lacking automated coverage for internal invariants stay Blocked rather than passing on weak evidence. Missing context must be supplied by the user before execution can proceed.