技能介绍

为什么需要专门清洗采购清单

在实际业务中，采购部门下发的订单往往不是规范的数据表，而是带有复杂表头、合并单元格或上下两层结构的 Excel 文件。上层是订单头信息（如订单号、供应商、合同号），下层才是明细行。如果直接用脚本读取，很容易丢失订单级信息，或者把合计行当成明细数据。采购清单清洗助手就是为了解决这种“脏数据”解析问题而生的离线脚本工具。

核心能力与处理流程

这个技能的核心在于理解采购文件的双层结构，并通过 scripts/clean_purchase_excel.py 进行确定性清洗。它的工作流非常清晰：

定位与提取：自动探测明细表头行，读取上方的订单头块，提取订单号、供应商等关键字段。
字段回填：将提取到的订单级字段回填到每一行明细中。如果明细行本身带有该字段（如每行的供应商名称），则以明细列的值为准。
跳过与标记：自动跳过合计行（如“合计”、“总计”），而不是报错；对于无效数据行，会进行标记而不是静默丢弃。
生成报告：输出清洗后的 cleaned_purchase_template.xlsx、Markdown 格式的校验报告以及错误日志 errors.csv。报告会明确记录每个回填值的来源行，防止错误回填污染数据。

适用边界与注意事项

该工具严格遵循离线文件处理原则，绝不连接任何实时采购或仓储系统，也不读写生产数据库。它仅负责格式转换和数据准备，不涉及财务核算、税务计算或价格合规性审查。

在金额处理上，它只做格式清洗，不自动计算金额。如果“小计”与“采购数量 × 单价”的偏差超过 1%，或者缺少小计，它会抛出提醒而不是自行补全。此外，它不会自动猜测文件类型，如果所有明细行均校验失败，报告会提示“可能选错了 Skill”，但最终决定权始终在用户手中。生成的文件仅作为人工复核前的准备文件，不可直接用于下单或审批。