defect-report-generator

name	defect-report-generator
description	将缺陷/任务清单 CSV 自动转换成一份自包含的 HTML 测试缺陷报告。当用户给出一份 CSV（含任务状态/标题/负责人/模块/逾期等列）并要求"生成测试报告""出一份缺陷分析报告""根据缺陷清单做统计报告"时使用。脚本仅用 Python 标准库，图表为内联 SVG + CSS（无 CDN），离线可打开。也适用于任务清单、Bug 列表、工单导出的质量分析。
agent_created	true

Defect Report Generator（缺陷/任务清单 → 测试报告）

Overview

把一份缺陷（或任务/工单）CSV 清单，一键生成一份自包含、可离线打开的 HTML 测试缺陷报告。 报告包含：KPI 概览卡片、状态分布环形图、模块分布条形图、各模块状态明细表、负责人分布、 未完成（未关闭）缺陷清单、逾期清单、测试结论与改进建议、数据说明共 8 个章节。

设计要点：仅依赖 Python 标准库（csv/re/math/html/argparse），不联网、不装包；图表手写内联 SVG + CSS，因此双击 HTML 即可打开，不会因缺 CDN 而白屏。

WHEN to use

• 用户给出一份 CSV 并说："生成测试报告 / 出缺陷分析报告 / 根据这份清单做统计 / 帮我看看缺陷情况"。
• 源文件是缺陷管理、Bug 跟踪、任务看板（TAPD/Jira/禅道等）导出的 CSV。
• 任务列表、工单列表、需求清单的"质量/进度"分析同样适用（列结构相同即可）。

Workflow（使用流程）

1. 确认输入：拿到 CSV 路径。若用户没给标题/项目名/测试周期，可用 --title / --project / --period 覆盖，或从 CSV 表头（项目列、开始/截止列）自动推断。
2. 运行脚本（隔离 Python 环境，不要污染用户系统）：

   /Users/zhushengping/.workbuddy/binaries/python/versions/3.13.12/bin/python3 \
     ~/.workbuddy/skills/defect-report-generator/scripts/generate_report.py \
     "<CSV路径>" -o "<输出HTML路径>" \
     [--title "报告标题"] [--project "项目名"] [--period "2026-07-10 ~ 2026-07-31"]
   

3. 核对输出：脚本会打印总数、各状态计数、未关闭数、逾期数、解决率、关闭率。 与业务预期对一下（例如"已验收=45、未关闭=11"是否合理）。
4. 交付：用 present_files 打开 HTML 预览交付；有必要则补充说明口径。

列自动识别规则（无需固定表头）

detect_columns() 按关键词模糊匹配表头，定位以下列（找不到则为空，统计降级）：

逻辑列	命中关键词
状态	状态 / status
标题	标题 / title / 名称 / summary / 主题 / 描述
负责人	负责人 / 处理人 / owner / assignee / 经办
模块	模块 / module
逾期	逾期 / overdue / late
任务ID	任务id / 缺陷id / bug id / id / 编号 / 序号
项目/开始/截止	项目 / 开始 / 截止·due·完成日期·结束

• 模块优先从标题首段 【xxx】 或 [xxx] 解析（extract_module），无括号才回退到模块列，都没有记"未分类"。
• 编码按 utf-8-sig → utf-8 → gbk → gb18030 依次尝试，兼容带 BOM / 中文导出的 CSV。

状态映射规则（6 桶模型）

业务状态千奇百怪，脚本用关键词顺序匹配把它们归一成 6 个标准桶 （CANON_RULES，顺序很重要，先匹配更具体的）：

标准桶	命中关键词（节选）	业务含义
已验收	已验收/已关闭/验收/closed/verified/已解决	测试确认关闭
已拒绝	已拒绝/拒绝/rejected/wontfix/不予修复/不是缺陷/设计如此/重复/不修复	开发拒绝或无效缺陷（视为已处理）
修复中	修复中/处理中/进行中/in progress/开发中	处理中
已修复	已修复/修复/fixed/resolved	待验证
待确认	待确认/待处理/待验证/待修复/pending/新建/打开/重新打开/待	未关闭
其他	（以上都不匹配）	无法归类

口径：「未关闭」= 已修复 + 修复中 + 待确认 + 其他； 「解决率」= (已验收 + 已拒绝) / 总数；「关闭率」= 已验收 / 总数。

⚠️ 维护提示：若"修复中"被错误并入"已修复"，说明 CANON_RULES 里 修复中 元组不在 已修复 之前， 保持顺序即可（修复中 必须在 已修复 之上，否则子串"修复"会把两者吞掉）。

输出报告章节

1. 顶部信息条（项目 / 测试周期 / 生成日期 / 总数）
2. KPI 卡片：缺陷总数、已验收、已拒绝、未关闭、逾期
3. 一、缺陷状态分布（环形图 + 图例 + 解决进度说明）
4. 二、缺陷模块分布（条形图，Top10 + 其他）
5. 三、各模块状态明细表
6. 四、负责人分布
7. 五、未完成（未关闭）缺陷清单
8. 六、逾期情况
9. 七、测试结论与建议（结论 + 改进建议两栏）
10. 八、数据说明与局限

局限与扩展

• 原数据若缺严重程度 / 优先级 / 发现版本等字段，报告不做相应分析（已在"数据说明"注明）。
• 可在脚本中扩展 CANON_RULES 适配更多状态词；需要 Word/PDF 输出可叠加 docx/pptx 技能。
• 换一份同结构 CSV，改路径重跑即更新，无需改代码。

Resources

scripts/

• generate_report.py —— 核心脚本，标准库实现，见上方"使用流程"。