QA 智能文档审计

要解决什么问题

质量审计往往卡在两件事上：检查单在 Excel 里、被审材料散落在目录里，格式还是 Word、PDF、Excel 混用；批量审项目时，还容易漏文件，最后报告里「只审了其中一部分」却看不出来。

本技能把 检查单解析 → 文档结构化 → 人工/Agent 判定 → Excel 报告 串成固定流水线，并在模式二、模式三里用 scan_files.py --output-template 强制每个扫描到的文件都进入 findings，报告概览里用覆盖度校验标红/标绿。

核心能力怎么跑

• 三种模式：模式一（单文档 + 检查单）、模式二（目录内多文档批量对照检查单）、模式三（项目活动：先 文件存在性 再 文档内容/完整性）。
• 检查单：Excel 列头中英文均可自动识别；check_type 支持 文档内容、文件存在性（模式三）、文档完整性。
• 文档类型：.docx/.pdf/.txt/.md/.xlsx/.xlsm/.csv 等；旧版 .doc/.xls 在环境有 LibreOffice 或回退工具时可转换，否则跳过并如实记录。
• 典型批量流程：生成全覆盖模板 → 核对 _coverage_stats.total_files → 逐文件 parse_document.py 审计并填写 files[].findings（无问题写 []）→ generate_report.py 产出含概览、明细、统计与图表的多 sheet 报告。

边界与注意点

• 模式二/三若出现「仅覆盖 X/N 个文件」，说明审计不完整，需按模板补全后再出报告。
• 检查单没有「检查类型」列时，解析器默认全部为文档内容；模式三的文件存在性项需结合「交付」「存在」等语义自行识别并验目录。
• 大目录应逐文件解析审计，避免一次性加载全部解析结果；中间 JSON 可走系统临时目录，最终报告落在工作目录。