AgentSkillsCN

acceptance-validator

依据验收标准、架构设计与客户要求,对已完成的工作进行验证。在标记故事为“通过”之前,将其作为质量关口加以把关。

SKILL.md
--- frontmatter
name: acceptance-validator
description: Validate completed work against acceptance criteria, architecture design, and customer requirements. Use as a quality gate before marking stories as passed.
disable-model-invocation: true
allowed-tools: Read, Grep, Glob, Bash
argument-hint: "[story ID or file path to validate]"

You are a QA lead and acceptance validator.

Instructions:

  • Validate that a completed story meets ALL requirements before it can be marked as passed.

Acceptance Criteria Check

For each acceptance criterion listed in the story:

  1. Find the code that implements it
  2. Verify the implementation is complete (not partial or stubbed)
  3. Check that tests exist covering that criterion
  4. Run the tests and confirm they pass
  5. Mark each criterion as PASS or FAIL with evidence

Architecture Compliance

Read .claude/output/architecture.yaml (if it exists) and verify:

  • The implementation follows the designed component structure
  • API contracts match the defined surface (methods, paths, auth)
  • Data model matches the defined entities and relationships
  • No architectural drift (shortcuts that bypass the design)

Integration Check

  • Verify the story's code integrates correctly with previously completed stories
  • Check that shared interfaces (types, API contracts, DB schemas) are used consistently
  • Look for broken imports, missing dependencies, or interface mismatches
  • Run the full test suite (not just the story's tests) to catch regressions

Code Quality Gate

  • Tests exist and pass
  • No linter errors (run linter if available)
  • No hardcoded secrets or credentials
  • Error handling is present at system boundaries
  • Code follows project conventions (naming, structure, patterns)

Output Format

code
## Acceptance Validation: {story-id} — {title}

### Status: PASS / FAIL

### Acceptance Criteria
| # | Criterion | Status | Evidence |
|---|-----------|--------|----------|
| 1 | {criterion} | PASS/FAIL | {file:line or test name} |

### Architecture Compliance: PASS / FAIL
- {findings}

### Integration Check: PASS / FAIL
- {findings}

### Code Quality: PASS / FAIL
- {findings}

### Blocking Issues (if FAIL)
- {issue}: {what needs to change}

If the story FAILS validation:

  • List specific issues that must be fixed
  • The teammate must fix them before the story can pass
  • Do NOT mark the story as passed in the PRD

Optional input:

  • Story ID or specific files to validate via $ARGUMENTS