AgentSkillsCN

acceptance-criteria-design

为已批准的需求编写通过/不通过的判定标准。仅在`REQ-*`项目稳定、且Codex必须明确可执行的验收条件时使用此功能;切勿用于需求挖掘或优先级排序。

SKILL.md
--- frontmatter
name: acceptance-criteria-design
description: Pass/fail criteria authoring for approved requirements. Use only when `REQ-*` items are stable and Codex must define executable acceptance conditions; do not use for requirement discovery or prioritization.

Acceptance Criteria Design

Trigger Boundary

  • Use when requirement wording is approved and implementation readiness is needed.
  • Do not use to define requirement intent; use requirements-definition.
  • Do not use to split sprint work; use user-story-writing.

Goal

Translate stable requirements into binary, testable acceptance conditions.

Shared Requirements Contract (Canonical)

  • Use ../requirements-definition/references/requirements-governance-contract.md as the single schema and gate source.
  • Track requirements workflow artifacts with RQM-* IDs.
  • Run machine validation: python3 ../requirements-definition/scripts/validate_requirements_contract.py --manifest <path/to/manifest.json>.

Inputs

  • Approved REQ-* and relevant NFR-*
  • Boundary conditions and known failure paths
  • Test environment capabilities

Outputs

  • AC-* conditions mapped to REQ-*
  • Positive, negative, and boundary test scenarios
  • Traceability table from requirement to verification method

Workflow

  1. Write behavior-focused pass/fail statements per requirement.
  2. Assign AC-* IDs and map each to one REQ-* ID.
  3. Include normal flow, edge conditions, and failure outcomes.
  4. Specify setup, inputs, and expected observable results.
  5. Review for ambiguity, overlap, and missing failure coverage.

Quality Gates

  • Every AC-* is independently verifiable.
  • Coverage includes negative and boundary paths.
  • Criteria map to requirement and NFR obligations.
  • Compliance conditions are testable and explicit.

Failure Handling

  • Reject criteria that cannot be executed in available environments.
  • Stop when requirement ambiguity prevents binary criteria.