About spec-test
spec-test is a skill for the verification phase of Spec Pack work, helping teams create test plans, manual cases, suites, and execution reports. It emphasizes traceability to acceptance criteria and explicit gates without requiring automated test code.
Key features
- 01Create test plans and risk lists
- 02Write executable manual cases from a template
- 03Organize smoke, regression, and targeted suites
- 04Record coverage, blockers, and defect references
- 05Check required context and flag gaps
Use cases
- 01Set verification scope and entry or exit criteria for a Spec Pack
- 02Turn acceptance criteria into executable manual cases
- 03Arrange test suites and execution order by priority
- 04Summarize coverage, results, and follow-up actions
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ zixun-github/ aisdlc --skill spec-testAfter installing, type/spec-testin Claude Code to confirm it loaded.
Details
From the project READMESpec Pack 验证(Verification)主技能:spec-test
本技能用于 Spec Pack 的 verification 阶段(V1–V4):生成/更新测试计划、测试用例、测试套件与测试报告。默认以手工测试为准;自动化仅作为可选增强。
何时使用
- 需要为某个 Spec Pack 产出或更新以下任一文件:
verification/test-plan.mdverification/usecase.mdverification/suites.mdverification/report-{date}-{version}.md
何时不使用
- 你要写自动化测试代码:本技能只负责 verification 文档产物与门禁,不要求在本阶段实现自动化代码。
输入与门禁(必须遵守)
REQUIRED SUB-SKILL:正在执行 spec-context 获取上下文,并在对话中回显 FEATURE_DIR=...(允许 (reuse))。
必读上下文
- 项目级:
project/memory/product.mdproject/memory/tech.mdproject/memory/glossary.md
- 需求级(至少其一):
{FEATURE_DIR}/requirements/solution.md或{FEATURE_DIR}/requirements/prd.md
缺失时必须在输出物中显式写 CONTEXT GAP,不得静默跳过。
子技能一览
| 子技能 | 产物(落盘) | 目的 |
|---|---|---|
spec-test-plan | {FEATURE_DIR}/verification/test-plan.md | 冻结范围/策略/环境/准入准出/风险清单 |
spec-test-usecase | {FEATURE_DIR}/verification/usecase.md | 将 AC 转为可手工执行的用例(强制使用用例模板) |
spec-test-suites | {FEATURE_DIR}/verification/suites.md | 组织 smoke/regression/targeted 套件与执行顺序 |
spec-test-execute | {FEATURE_DIR}/verification/report-{date}-{version}.md | 记录执行结果并给出结论(覆盖/阻断/缺陷引用/风险建议) |
spec-test-bug | (不落盘 bug 文件) | 生成可直接粘贴到外部缺陷系统的缺陷报告正文,并指导把缺陷引用回写到 report-*.md |
平替能力范围(对齐 qa-test-planner 的核心能力)
在不依赖 qa-test-planner 的前提下,本技能组提供以下能力并适配本仓库约束:
- 测试计划(V1):范围/策略/环境/准入准出/风险清单;包含回归分层(smoke/targeted/full)与阻断口径。
- 手工测试用例(V2):按统一模板生成;每步可判定;AC 可追溯;可为后续自动化生成保留结构信息(但不要求在本阶段写自动化代码)。
- 测试套件(V3):smoke/regression/targeted;条目必须可定位到
TC-*;执行顺序与阻断口径与 test-plan 对齐。 - 测试报告(V4):覆盖统计(套件/优先级)、AC↔TC 覆盖映射、阻断项、缺陷引用清单、结论与下一步动作(可执行)。
- 缺陷报告(Vx):输出可直接粘贴到外部缺陷系统的缺陷报告正文;外部缺陷创建/更新后,必须将编号/链接/状态/严重程度与关联 TC 回写到
report-*.md。
通用约束
- 缺陷不在 Spec Pack 内单独落盘:禁止新增
verification/bugs/**;仅在report-*.md的“缺陷清单”里引用外部缺陷系统(编号/链接/状态/严重程度/关联 TC)。
Comments
Markdown supported