测试报告（中文版）
英文版： 见技能 test-reporting-en 。
提示词见本目录 prompts/test-reporting.md 。
何时使用
-
用户提到「测试报告」「test reporting」「测试总结」
-
需要生成测试报告或测试总结
-
触发示例：「生成测试报告」「编写 Sprint 测试总结」
输出格式选项
本技能默认输出为 Markdown。若需其他格式，请在需求末尾明确说明。
如何使用
-
打开本目录 prompts/ 下对应提示词文件，复制虚线以下内容。
-
附加你的需求与上下文（业务流程、环境、约束、验收标准）。
-
若需非 Markdown 输出，在末尾追加 output-formats.md 中的请求句。
参考文件
-
prompts/test-reporting.md — 测试报告提示词
-
output-formats.md — 格式说明
代码示例 | Code Examples
- 测试报告模板（计划中） - 各类测试报告模板
常见误区 | Common Pitfalls
-
❌ 只有数据没有分析 → ✅ 提供洞察和建议
-
❌ 报告过于冗长 → ✅ 突出重点，分层展示
-
❌ 缺少可视化 → ✅ 使用图表展示趋势
-
❌ 没有行动项 → ✅ 明确后续行动
最佳实践 | Best Practices
- 报告结构
测试报告
1. 执行摘要
- 测试概况
- 主要发现
- 质量评估
- 建议
2. 测试执行
- 执行统计
- 覆盖率
- 通过率
3. 缺陷分析
- 缺陷统计
- 严重程度分布
- 趋势分析
4. 风险与问题
- 当前风险
- 阻塞问题
- 缓解措施
5. 后续计划
- 待完成工作
- 改进建议
- 行动项
- 关键指标
执行指标:
-
用例总数
-
执行数量
-
通过率
-
失败率
质量指标:
-
缺陷密度
-
缺陷逃逸率
-
修复时间
-
重开率
效率指标:
-
自动化率
-
执行时间
-
生产力
故障排除 | Troubleshooting
问题1：报告太长没人看
解决方案： 使用金字塔结构：
-
执行摘要（1页）
-
关键指标（1页）
-
详细数据（附录）
问题2：数据不准确
解决方案：
-
使用测试管理工具
-
自动化数据收集
-
定期校验数据
相关技能： test-strategy、bug-reporting、test-case-writing。
目标受众
-
在真实项目中执行该测试域工作的 QA 与开发人员
-
需要结构化、可复用测试交付物的测试负责人
-
需要快速生成可落地测试产出的 AI 使用者
不适用场景
-
无测试范围上下文的纯线上应急处置
-
需要法律/合规最终裁定但缺少专家复核的决策
-
缺少最小输入（范围、环境、期望行为）的请求
关键成功因素
-
先明确范围、环境与验收标准，再生成测试内容
-
生成结果必须结合真实系统约束做二次校验
-
保持产物可追踪（需求 -> 测试点 -> 缺陷 -> 决策）
输出模板与解析脚本
-
模板目录：output-templates/
-
template-word.md （Word 友好结构）
-
template-excel.tsv （Excel 可直接粘贴）
-
template-xmind.md （XMind 结构化大纲）
-
template-json.json
-
template-csv.csv
-
template-markdown.md
-
解析脚本目录：scripts/
-
解析通用：parse_output_formats.py
-
解析按格式：parse_word.py 、parse_excel.py 、parse_xmind.py 、parse_json.py 、parse_csv.py 、parse_markdown.py
-
转换通用：convert_output_formats.py
-
转换按格式：convert_to_word.py 、convert_to_excel.py 、convert_to_xmind.py 、convert_to_json.py 、convert_to_csv.py 、convert_to_markdown.py
-
批量转换：batch_convert_templates.py （批量输出到 artifacts/ ）
示例：
python3 scripts/parse_json.py output-templates/template-json.json python3 scripts/parse_markdown.py output-templates/template-markdown.md python3 scripts/convert_to_json.py output-templates/template-markdown.md python3 scripts/convert_output_formats.py output-templates/template-json.json --to csv python3 scripts/batch_convert_templates.py --skip-same