SuperAPI AI Directory

spec-test-usecase

Testing & quality

View repository

Updated 10-16 08:49

About this skill

Spec Test Cases (V2: Usecase)

Convert the acceptance criteria (AC) in requirements/solution.md / requirements/prd.md into executable, verifiable, traceable manual test cases.


Inputs and Gates (must be followed)

REQUIRED SUB-SKILL: currently executing spec-context to obtain context, and echo in the conversation FEATURE_DIR=...(allowed (reuse))。

  • Required reading of project-level memory:project/memory/product.md、project/memory/tech.md、project/memory/glossary.md; if it cannot be read, you must write CONTEXT GAP。
  • Minimum requirement-level input:{FEATURE_DIR}/requirements/solution.md or {FEATURE_DIR}/requirements/prd.md at least one of them must exist; otherwise stop and write CONTEXT GAP。
  • Mandatory use of template:usecase.md must directly use the use case template assets/test_usercase_template.md(do not invent a structure, do not change field names/section names).

Output (write to disk)

  • {FEATURE_DIR}/verification/usecase.md

Mandatory template (must be followed)

  • usecase.md must be generated according to the template (do not invent a structure/field names/section names):
    • assets/test_usercase_template.md

Content requirements

  • Each test case must be filled in according to the template (at least the "Standard Test Case Template" section)
  • Each step must have an observable expected result (able to determine Pass/Fail/Blocked)
  • Each test case must be traceable to an AC (pointing to solution/prd)

Note:

  • In the template, the status/execution history/defect ID fields are used to align with V4 report-*.md ; execution results and defect references are based on report-*.md (do not add new defect files/directories within the Spec Pack).

DoD self-check (V2-DoD)

  • P0/P1 test cases are all "executable": preconditions and data are not missing
  • Every step has an "expected result" (observable, verifiable)
  • AC coverage relationships are clear (at least able to answer "which ACs are covered by which test cases")
  • Each test case is filled in according to the assets/test_usercase_template.md template (fields and sections are not missing)