SuperAPI AI Directory

spec-test

Testing & quality

View repository

Updated 10-16 01:32

About this skill

Spec Pack Verification main skill: spec-test

This skill is used in the verification stage (V1–V4) of a Spec Pack: generate/update test plans, test cases, test suites, and test reports. By default it usesmanual testingas the standard; automation is only an optional enhancement.


When to use

  • When you need to produce or update any of the following files for a Spec Pack:
    • verification/test-plan.md
    • verification/usecase.md
    • verification/suites.md
    • verification/report-{date}-{version}.md

When not to use

  • You want to write automated test code: this skill is only responsible for verification document artifacts and gating, and does not require implementing automated code in this stage.

Inputs and gating (must be followed)

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

Required context

  • Project level:
    • project/memory/product.md
    • project/memory/tech.md
    • project/memory/glossary.md
  • Requirement level (at least one):
    • {FEATURE_DIR}/requirements/solution.md or {FEATURE_DIR}/requirements/prd.md

When missing, you must explicitly write in the output artifact CONTEXT GAP, and must not silently skip it.


Sub-skill overview

Sub-skill Artifact (saved to disk) Purpose
spec-test-plan {FEATURE_DIR}/verification/test-plan.md Freeze scope/strategy/environment/entry-exit criteria/risk list
spec-test-usecase {FEATURE_DIR}/verification/usecase.md Convert ACs into manually executable cases (mandatory use of the case template)
spec-test-suites {FEATURE_DIR}/verification/suites.md Organize smoke/regression/targeted suites and execution order
spec-test-execute {FEATURE_DIR}/verification/report-{date}-{version}.md Record execution results and give conclusions (coverage/blockers/defect references/risk recommendations)
spec-test-bug (no bug files saved to disk) Generate defect report body text that can be pasted directly into an external defect system, and guide writing defect references back to report-*.md

Equivalent capability scope (aligned with the core capabilities of qa-test-planner)

Without relying on qa-test-planner , this skill group provides the following capabilities and adapts them to this repository's constraints:

  • Test plan (V1): scope/strategy/environment/entry-exit criteria/risk list; includes regression layering (smoke/targeted/full) and blocking criteria.
  • Manual test cases (V2): generated according to a unified template; each step is verifiable; ACs are traceable; structural information can be retained for subsequent automation generation (but writing automation code in this stage is not required).
  • Test suites (V3): smoke/regression/targeted; entries must be locatable to TC-*; execution order and blocking criteria align with test-plan.
  • Test report (V4): coverage statistics (suite/priority), AC↔TC coverage mapping, blockers, defect reference list, conclusions, and next actions (executable).
  • Defect report (Vx): output defect report body text that can be pasted directly into an external defect system; after the external defect is created/updated, the ID/link/status/severity and associated TC must be written back to report-*.md。

General constraints

  • Defects are not saved separately within the Spec Pack: adding is prohibited verification/bugs/**; only reference the external defect system (ID/link/status/severity/associated TC) in the “defect list” of report-*.md .