Back to Details

test-reporting-en

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Test Reporting

测试报告

中文版： 见技能 
test-reporting
。
Prompts: see 
prompts/test-reporting_EN.md
in this directory.
中文版： 见技能 
test-reporting
。
提示词：请查看本目录下的
prompts/test-reporting_EN.md
文件。

When to Use

适用场景

  • User mentions test reporting, test summary, or test report
  • Need to generate test reports or test summaries
  • Trigger: e.g. "Generate test report" or "Write Sprint test summary"
  • 用户提到test reporting、test summary或者test report
  • 需要生成测试报告或测试摘要
  • 触发词示例： 例如“Generate test report”或者“Write Sprint test summary”

Output Format Options

输出格式选项

This skill defaults to Markdown output. For other formats, specify at the end of your request.
本技能默认输出Markdown格式。如需其他格式，请在请求末尾指定。

How to Use

使用方法

  1. Open the relevant file in this directory's 
    prompts/
    and copy the content below the dashed line.
  2. Append your requirements and context (business flow, environment, constraints, acceptance criteria).
  3. If you need non-Markdown output, append the request sentence from 
    output-formats.md
    at the end.
  1. 打开本目录
    prompts/
    文件夹下的相关文件，复制虚线以下的内容。
  2. 附上你的需求和上下文（业务流程、环境、约束条件、验收标准）。
  3. 如果你需要非Markdown格式的输出，在末尾加上
    output-formats.md
    中对应的请求语句。

Reference Files

参考文件

  • prompts/test-reporting_EN.md — Test reporting prompts
  • output-formats.md — Format specifications
  • prompts/test-reporting_EN.md — 测试报告提示词
  • output-formats.md — 格式规范

Code Examples

代码示例

  1. Test Report Templates (Planned) - Various test report templates
  1. 测试报告模板（规划中） - 多种测试报告模板

Common Pitfalls

常见误区

  • ❌ Only data without analysis → ✅ Provide insights and recommendations
  • ❌ Report too lengthy → ✅ Highlight key points, layered presentation
  • ❌ Missing visualizations → ✅ Use charts to show trends
  • ❌ No action items → ✅ Specify follow-up actions
  • ❌ 只有数据没有分析 → ✅ 提供洞察和建议
  • ❌ 报告过于冗长 → ✅ 突出重点，分层展示
  • ❌ 缺少可视化内容 → ✅ 使用图表展示趋势
  • ❌ 无行动项 → ✅ 明确后续行动

Best Practices

最佳实践

1. Report Structure

1. 报告结构

markdown
undefined
markdown
undefined

Test Report

Test Report

1. Executive Summary

1. Executive Summary

  • Test overview
  • Key findings
  • Quality assessment
  • Recommendations
  • Test overview
  • Key findings
  • Quality assessment
  • Recommendations

2. Test Execution

2. Test Execution

  • Execution statistics
  • Coverage
  • Pass rate
  • Execution statistics
  • Coverage
  • Pass rate

3. Defect Analysis

3. Defect Analysis

  • Defect statistics
  • Severity distribution
  • Trend analysis
  • Defect statistics
  • Severity distribution
  • Trend analysis

4. Risks and Issues

4. Risks and Issues

  • Current risks
  • Blocking issues
  • Mitigation measures
  • Current risks
  • Blocking issues
  • Mitigation measures

5. Next Steps

5. Next Steps

  • Pending work
  • Improvement suggestions
  • Action items
undefined
  • Pending work
  • Improvement suggestions
  • Action items
undefined

2. Key Metrics

2. 关键指标

Execution Metrics:
  • Total test cases
  • Executed count
  • Pass rate
  • Failure rate
Quality Metrics:
  • Defect density
  • Defect escape rate
  • Fix time
  • Reopen rate
Efficiency Metrics:
  • Automation rate
  • Execution time
  • Productivity
执行指标:
  • 总测试用例数
  • 已执行用例数
  • 通过率
  • 失败率
质量指标:
  • 缺陷密度
  • 缺陷逃逸率
  • 修复时长
  • 重开率
效率指标:
  • 自动化率
  • 执行时长
  • 生产率

Troubleshooting

问题排查

Issue 1: Report too long, nobody reads it

问题1: 报告太长没人阅读

Solution: Use pyramid structure:
  1. Executive summary (1 page)
  2. Key metrics (1 page)
  3. Detailed data (appendix)
解决方案: 采用金字塔结构:
  1. 执行摘要（1页）
  2. 核心指标（1页）
  3. 详细数据（附录）

Issue 2: Data inaccurate

问题2: 数据不准确

Solution:
  1. Use test management tools
  2. Automate data collection
  3. Regularly validate data
Related Skills: test-strategy-en, bug-reporting-en, test-case-writing-en.
解决方案:
  1. 使用测试管理工具
  2. 自动化数据采集
  3. 定期校验数据
相关技能: test-strategy-en, bug-reporting-en, test-case-writing-en.

Target Audience

适用人群

  • QA engineers and developers executing this testing domain in real projects
  • Team leads who need structured, reproducible testing outputs
  • AI users who need fast, format-ready deliverables for execution and reporting
  • 在实际项目中从事该测试领域工作的QA工程师和开发人员
  • 需要结构化、可复用测试输出的团队负责人
  • 需要快速生成符合格式要求的执行和报告交付物的AI用户

Not Recommended For

不适用场景

  • Pure production incident response without test scope/context
  • Decisions requiring legal/compliance sign-off without expert review
  • Requests lacking minimum inputs (scope, environment, expected behavior)
  • 不涉及测试范围/上下文的纯生产事件响应
  • 无需专家审核即可通过的需法律/合规审批的决策
  • 缺少最低输入信息（范围、环境、预期行为）的请求

Critical Success Factors

关键成功要素

  • Provide clear scope, environment, and acceptance criteria before generation
  • Validate generated outputs against real system constraints before execution
  • Keep artifacts traceable (requirements -> test points -> defects -> decisions)
  • 生成前提供明确的范围、环境和验收标准
  • 执行前对照实际系统约束验证生成的输出内容
  • 保持工件可追溯（需求 -> 测试点 -> 缺陷 -> 决策）

Output Templates and Parsing Scripts

输出模板和解析脚本

  • Template directory: 
    output-templates/
    • template-word.md
      (Word-friendly structure)
    • template-excel.tsv
      (Excel paste-ready)
    • template-xmind.md
      (XMind-friendly outline)
    • template-json.json
    • template-csv.csv
    • template-markdown.md
  • Parser scripts directory: 
    scripts/
    • Parse (generic): 
      parse_output_formats.py
    • Parse (per-format): 
      parse_word.py
      , 
      parse_excel.py
      , 
      parse_xmind.py
      , 
      parse_json.py
      , 
      parse_csv.py
      , 
      parse_markdown.py
    • Convert (generic): 
      convert_output_formats.py
    • Convert (per-format): 
      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: 
      batch_convert_templates.py
      (outputs into 
      artifacts/
      )
Examples:
bash
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
  • 模板目录: 
    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/
      目录）
示例:
bash
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