qa-test-reporting

SKILL.md

---
name: qa-test-reporting
description: >-
  输出面向不同受众的测试报告——日报给团队同步进度、周报给项目经理、质量报告给管理层决策。当测试执行完成需要汇总结果、或者上级问"质量怎么样"的时候使用此技能。不同角色关心的数据不同：开发关心Bug明细，经理关心通过率和趋势，老板关心风险和发版决策。报告内容适配受众，关键指标量化呈现，风险区域必须单独成节并醒目标注。
  触发场景：测试报告、日报、周报、迭代报告、报告模板、质量汇报、进度汇报、向管理层汇报测试进展时。 Use when the user asks about: writing test reports for different audiences — daily reports for the team, weekly reports for the PM, and quality summaries for management.
license: MIT
allowed-tools: Read Grep Glob
metadata:
  display-name: "Test Reporting"
  version: "1.8.0"
  when-to-use: "用户说\"测试报告\"、\"日报\"、\"周报\"、\"迭代报告\"、\"报告模板\"、\"质量汇报\"、\"进度汇报\"、需要编写测试报告、向管理层汇报测试进展时"
  related-skills: "{\"upstream\":[\"qa-quality-metrics\",\"qa-bug-lifecycle\",\"qa-execution-observation\"],\"downstream\":[\"qa-stakeholder-communication\",\"qa-retrospective\"]}"
  references: "[\"references/audience-needs.md\",\"assets/report-templates.md\"]"
  input-format: "{\"required\":[{\"name\":\"测试执行数据\",\"type\":\"object\",\"description\":\"测试执行结果和统计（来自qa-execution-observation的执行记录）\"},{\"name\":\"缺陷数据\",\"type\":\"object\",\"description\":\"缺陷统计和分析数据（来自qa-bug-lifecycle）\"}],\"optional\":[{\"name\":\"质量度量\",\"type\":\"object\",\"description\":\"来自qa-quality-metrics的质量数据\"},{\"name\":\"准出标准\",\"type\":\"object\",\"description\":\"来自qa-test-strategy-design的本项目准出标准，用于报告中的目标值对比\"}]}"
  output-format: "{\"traceability\":[\"每份测试报告带唯一ID：RPT-{模块缩写}-{三位序号}\",\"聚合上游 ID：用例 TC_ / 缺陷 BUG- / 需求 REQ- / 风险 RISK-\"],\"structure\":[{\"report\":\"测试报告：按类型选结构 —— 日报(今日完成+阻塞项+明日计划) / 周报(指标趋势+待决策项) / 迭代报告(执行摘要+质量数据+缺陷分析+风险评估+改进建议+附件) / 专项报告(目标+范围+环境+方法+结果+问题分析+结论)\"},\"质量结论只有三种：通过 / 有条件通过（须写明条件与责任人）/ 不通过；禁用「基本通过」「风险可控」等无法判定的措辞\",\"结论与发布建议必须前置，不得埋在末尾\",\"目标值取自 qa-test-strategy-design 的本项目准出标准并注明出处，不照抄通用模板\",\"风险必须单独成节，标注 RISK- ID、责任人与应对；不得只报好消息\",\"本技能不产出 9 列用例表 —— 只汇总，用例由 qa-test-case-design 定义\"]}"
  error-recovery-guidance: "{\"on_failure\":\"报告遗漏受众关注点时回退到质量度量补充数据\",\"retry_behavior\":\"补充数据后重新生成报告\"}"
  categories: "[\"Development\",\"Testing\",\"DevOps\"]"
  depth-requirement: "{\"reference_value\":\"按受众与频率调整报告深度：日报/周报精简，迭代报告完整，专项报告按方法论展开\",\"minimum\":\"至少包含 进度/质量/风险/下一步 四个核心章节；风险章节不可省略\"}"
---

> ⚠️ 本技能单独使用效果有限，建议配合完整技能集（12 步工作流）使用。安装：npx skills add Kokxi/qa-test-skills

> **⚠️ 安全警告**：本技能的示例可能涉及发布建议和延期结论字段。
> 这些是报告字段不是直接操作；请勿未经授权即执行发布或延期决策。
> 本技能仅在 workspace/ 输出评估文件，不持久化、不外传、不跨会话复用。

# 测试报告编写

## 核心原则

**测试报告不是数据堆砌，而是决策支持**——让读者快速得到答案，而不是读完报告还要再问一次。

## 1. 先定受众，再选报告类型

| 报告类型 | 受众 | 频率 | 主体篇幅应给 |
|---------|------|------|------------|
| **日报** | 测试团队、开发 | 每日 | 今日完成 + 阻塞项 |
| **周报** | 测试负责人、PM | 每周 | 指标趋势 + 待决策项 |
| **迭代报告** | 项目团队、管理层 | 每迭代 | 质量结论 + 发布建议 + 风险 |
| **专项报告** | 相关方 | 按需 | 方法 + 结果对比基线 + 根因 |

| 受众 | 最关心 | 最不关心 |
|------|-------|---------|
| 开发 | Bug 明细、复现步骤、定位信息 | 覆盖率、趋势图 |
| PM / 测试负责人 | 通过率、进度、阻塞项、资源缺口 | 单个 Bug 细节 |
| 管理层 | 风险、是否发版、资源投入 | 用例执行明细 |
| QA 团队 | 覆盖率分布、遗留风险、个人任务 | — |

> 放错重点比数据缺失更糟：把 80% 篇幅花在对方不关心的指标上，对方仍然答不出决策问题。
> 详细受众分析见 [`references/audience-needs.md`](references/audience-needs.md)。

## 2. 质量结论：只有三种

| 结论 | 含义 | 附带要求 |
|------|------|---------|
| **通过** | 满足全部准出标准 | — |
| **有条件通过** | 主体满足，存在已知且可接受的风险 | **必须写明条件与责任人** |
| **不通过** | 不满足准出标准 | 必须写明差距与补齐计划 |

> **禁用**"基本通过""整体可控""风险可控"这类措辞——无法判定，等于没结论。
> 需要模糊空间时用"有条件通过"并把条件写清楚。

## 3. 加载时机

| 什么时候读 | 读哪个 |
|-----------|--------|
| 拿报告模板填 | [`assets/report-templates.md`](assets/report-templates.md)（四类模板 + 填写要求 + 自检） |
| 不确定某受众该看什么、或报告被说"没重点" | [`references/audience-needs.md`](references/audience-needs.md) |

## 4. 五个硬规则

1. **结论前置** —— 管理层只看前三分之一，质量结论与发布建议不能埋在末尾
2. **风险单独成节** —— 标注 `RISK-` ID、责任人与应对措施。**只报好消息是本报告最严重的失败**
3. **数字可追溯** —— 每个数字都能追到用例执行明细或缺陷清单
4. **目标值注明出处** —— 取自 `qa-test-strategy-design` 的本项目准出标准，
   **不要照抄 ≥95%/≥90%**：长期执行率 100% 的团队把准出定在 95% 等于没拦截作用
5. **覆盖率标注口径** —— 写"基于现有需求文档的覆盖率"，禁止"全覆盖/100%"

## 5. 产出

```markdown
# 迭代测试报告 —— [迭代名]

## 1. 执行摘要     → 迭代目标 / 测试范围（含不测什么）/ **质量结论** / **发布建议**
## 2. 质量数据     → 指标 | 结果 | 目标 | 状态（目标注明出处）
## 3. 缺陷分析     → 按严重程度 / 按模块 / 密度 / Top3 高频模式
## 4. 风险评估     → 风险 | 等级 | RISK- 依据 | 应对 | 责任人
## 5. 改进建议     → 流程 / 工具 / 能力
## 6. 附件         → 用例执行明细 / 缺陷清单 / 趋势图
```

> 四类报告的完整模板见 `assets/report-templates.md`。
> **本技能只汇总，不产出用例。**

## 6. 交付前自检

- [ ] 报告类型与受众匹配（没有一稿多投）
- [ ] **质量结论与发布建议已前置**，且措辞为三种之一
- [ ] 所有数字可追溯到用例执行明细或缺陷清单
- [ ] 风险单独成节，每条有 `RISK-` ID、责任人与应对措施
- [ ] 目标值注明了出处（项目准出标准），未照抄模板
- [ ] 覆盖率标注了口径，无绝对化表述
- [ ] "不测什么"已说明
- [ ] 待决策项写清了"谁/何时/决策什么"