| 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 文档撰写类。把"测试是补丁"转成"测试是设计的一部分"。
强制章节
- 测试目标(每条对应 REQ-*)
- 单元测试矩阵(function × case)
- 集成测试场景(含上下游 mock 策略)
- 契约测试(IDL 兼容性)
- 压测计划(目标 QPS / 数据集 / 退化曲线)
- 灰度验证 checklist(指标 / 阈值 / 监控)
- 测试数据治理(脱敏 / 隔离 / 清理)
模板片段
## 单元测试矩阵 — 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 复现用例)