# Verify Test

> 三层测试体系与测试前置。Use when 为功能编写测试、需要保证测试覆盖、或在编码前制定测试计划时。也适用于需要单元测试/功能测试/使用示例三层覆盖、确认正常与异常路径的场景。

- Skill: `swustcyt/verify-test` (Agent Skill)
- Install (CLI): `npx skillmds@latest add swustcyt/verify-test`
- Raw SKILL.md: https://api.skillmd.com/api/skills/swustcyt/verify-test/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: SWUSTcyt (https://skillmd.com/u/swustcyt)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/swustcyt/verify-test

---


# Verify-Test：三层测试

## 概述

为实现建立三层测试覆盖：单元测试、功能测试、使用示例（Examples）；并在编码前先出测试计划。

**核心原则：** 测试用例前置——先想清楚「要验证什么」，再写实现。

## 何时使用

- 实现一个 Issue 时（与 execute-implement 配套）
- 编码前制定测试计划
- 修 Bug 时先写复现测试

## 三层测试体系

| 层级 | 覆盖范围 | 要求 |
|---|---|---|
| 单元测试 | 函数/方法的正常路径 + 边界 + 异常 | 覆盖率 ≥ 80% |
| 功能测试 | API/模块完整请求-响应链路 | 至少 1 正常 + 1 异常 |
| Examples | API/模块典型用法 | 2-3 个实际使用场景 |

## 流程

1. **出测试计划** — 编码前列出测试场景（正常 / 边界 / 异常）+ 预期结果，交用户确认。
2. **写单元测试** — 覆盖正常、边界、异常三类输入。
3. **写功能测试** — 至少一条正常链路 + 一条异常链路。
4. **写 Examples** — 2-3 个真实用法示例。
5. **本地跑全绿** — 提交前测试、lint 全部通过（本地/单人即 L1 自动验收）。

> **验收硬规则（功能不回退）**：凡声称「功能不回退 / 可用」，必须至少跑通一次**关键路径的真实端到端冒烟**（真实模型 / 外部服务 / 工具链，而非仅构建或起服务）。若因缺密钥、环境等跑不了，该项只能标 **blocked / 待人工**，**不得标 done**。「构建通过」「服务能起来」只是 L1 烟雾，**不等于**功能测试。

## 产出

- 三层测试代码 + 测试计划（场景 + 预期）

## 提示词参考

> 为以下函数编写单元测试，覆盖正常输入、边界值、异常输入三种情况；再补一条正常 + 一条异常的功能测试，以及 2-3 个使用示例。

## 常见错误

- **只测正常路径** → 边界与异常是 Bug 高发区，必须覆盖。
- **测 mock 而非真实行为** → 测试通过但代码可能错。优先真实代码，mock 仅在不可避免时用。
- **编码后才补测试** → 测试被实现带偏，沦为「描述现状」而非「定义预期」。坚持前置。
- **用「构建通过 / 服务起得来」冒充「功能不回退」** → 构建烟雾和起服务只能证明能加载，证明不了业务链路。关键路径必须真实端到端走一遍；跑不了就标 blocked，别给假绿灯。

## 参考

- 配套：`skills/execute-implement/SKILL.md`、`skills/verify-review/SKILL.md`
- 借鉴：`reference/vendored-skills/superpowers/skills/test-driven-development`
- 方法论出处：唯一真源 `docs/AI 编程方法论 v1.2 — 可操作版.md` 第 3.1 / 3.3 节