---

name: testing-guide description: Opinionated constraints for writing effective tests. Guide unit tests, integration tests, and E2E tests with quality metrics beyond coverage. Use when users write tests, review test code, or need testing strategy. Triggers on keywords like "test", "testing", "单元测试", "集成测试", "E2E", "测试质量", "coverage", "断言". allowed-tools: Read, Write, Glob, Grep, Edit, Bash, AskUserQuestion

Testing Guide

编写高质量测试的约束规范，确保测试真正验证行为而非仅仅覆盖代码。

Language

• Accept questions in both Chinese and English
• Always respond in Chinese

Trigger Conditions

• 用户正在编写测试代码
• 用户需要测试策略指导
• 用户提到测试覆盖率、断言、变异测试
• Code Review 中涉及测试代码

---

核心理念

Copy测试的目的不是"覆盖代码"，而是"验证行为"。
测试依据来自需求，不是来自代码。

测试质量金字塔

CopyLevel 3: 测试有效性 ─ 变异得分≥80%, 需求追溯100%
Level 2: 断言质量   ─ 禁止弱断言, 验证行为非实现
Level 1: 代码覆盖   ─ 行/分支覆盖≥80% (必要非充分)

详细说明见 templates/core-concepts.md

---

Constraints

单元测试约束

• 每个测试必须有 ≥1 个具体断言
• 禁止弱断言作为唯一断言 (toBeDefined, toBeTruthy, not.toBeNull)
• 测试名称必须描述预期行为
• 测试依据来自需求，不是代码
• 只 Mock 外部依赖，不 Mock 内部实现
• 每个测试只验证一个行为

详细指南见 templates/unit-testing.md

覆盖率约束

• 行覆盖率 ≥ 80%
• 分支覆盖率 ≥ 80%
• 覆盖率是必要条件，不是充分条件

变异测试约束（推荐）

• 变异得分 ≥ 60%（建议 ≥ 80%）
• 核心业务逻辑变异得分 ≥ 80%

配置见 templates/mutation-testing.md

集成测试约束

• 必须验证模块间数据流
• 必须验证接口契约
• 测试数据必须独立

详细指南见 templates/integration-testing.md

E2E 测试约束

• P0 场景必须 100% 覆盖
• 使用显式等待，禁止硬编码延时
• 测试必须可独立运行

详细指南见 templates/e2e-testing.md

需求追溯约束

• 每个需求必须有对应测试
• 测试代码应标注需求ID

模板见 templates/traceability-matrix.md

---

Quick Reference

测试命名

Copy[被测方法] 应该 [预期行为] 当 [条件]

测试结构 (AAA)

CopyArrange → Act → Assert (具体断言)

禁止的弱断言

Copy// ❌ 禁止
expect(result).toBeDefined();
expect(result).toBeTruthy();
expect(result).not.toBeNull();

// ✅ 要求
expect(result.status).toBe('success');
expect(result.items).toHaveLength(3);

常用命令

Copy# 覆盖率
npm test -- --coverage          # Jest
pytest --cov=src               # pytest
go test -cover ./...           # Go

# 变异测试
npx stryker run                # JS/TS
mutmut run                     # Python
mvn pitest:mutationCoverage    # Java

---

模板索引

核心指南

工具配置

语言最佳实践

---

与其他 Skills 协作