test-plan-doc-writer

name	test-plan-doc-writer
description	阶段 3.2 / 4.1 撰写 test-plan.md——覆盖单测、集成、契约、压测、灰度验证。
allowed-tools	Read, Write, Edit

Skill: test-plan-doc-writer

原文 §8.3 文档撰写类。把"测试是补丁"转成"测试是设计的一部分"。

强制章节

1. 测试目标（每条对应 REQ-*）
2. 单元测试矩阵（function × case）
3. 集成测试场景（含上下游 mock 策略）
4. 契约测试（IDL 兼容性）
5. 压测计划（目标 QPS / 数据集 / 退化曲线）
6. 灰度验证 checklist（指标 / 阈值 / 监控）
7. 测试数据治理（脱敏 / 隔离 / 清理）

模板片段

## 单元测试矩阵 — FT-002

| 函数 | 用例 | 期望 | 覆盖 REQ |
|---|---|---|---|
| validateTagRule | AND/OR/NOT 各 1 例 | 全通过 | REQ-001 |
| validateTagRule | 非法 JSON | 4010001 错误 | REQ-001 |
| createTask | 重复 task_id | 幂等返回原 task | REQ-004 |
| createTask | 用户数 > 10000 | 4010003 | REQ-002 |

与 test-runner Agent 的协作

• 本 Skill：写测试计划（什么时候测什么）
• test-runner：跑测试，记录结果

反模式

• ❌ 只列功能用例，不列性能/异常用例
• ❌ 单测覆盖率目标 < 70% 而无理由
• ❌ 无回归用例（必须包含上一版本已知 bug 复现用例）