社保公积金账单核对

问题背景

社保和公积金账单按月生成，两份文件来自不同系统或不同月份的导出结果，列名、顺序甚至小数位都不一致。人工逐行核对几十个字段，先要花大量时间确认“这列是不是公司承担的社保金额”“两表怎么对应到同一个人”，真正用于发现差异的精力反而所剩无几。更常见的情况是：某个工号在上月已离职，下月表中没有对应记录；或者姓名列存在重复，导致张冠李戴。

技能如何工作

上传两份 CSV 或 XLSX 并说明它们分别对应哪两个月即可。技能不会先要求整理 JSON，也不会反复追问员工编号，而是直接读取表头与前几行，自动确认文件口径：

• 在两表中寻找共有的工号、员工编号、人员编号或姓名列，候选列必须在各自文件内非空且唯一；
• 姓名只有在两边都唯一时才会被采用，不使用身份证号做匹配；
• 自动识别社保金额、公积金金额以及可选的服务费列，仅在口径含糊时提出一个具体问题，例如“这两列中哪一列是公司实际承担的社保金额？”

CSV 可直接交给脚本处理：python scripts/audit_bills.py --previous-csv <上月> --current-csv <本月> --output-dir <输出目录>。XLSX 会先由表格能力读取并整理为同一规则，或保存为临时 CSV 后执行同一脚本。技能最终交付一份 Markdown 报告与 账单差异明细.csv，若环境支持表格工具，还会生成带筛选、冻结首行和金额格式的 XLSX。

适用边界与注意点

• 报告会明确说明本次采用的匹配列、金额列、差异阈值以及两份文件的口径，便于复核而非直接下结论。
• 差异只表示需要复核，不代表责任归属或实际缴费状态，仍需结合业务方确认。
• 当没有任何安全的匹配列时，技能会停止逐人比较，直接指出重复或空值问题，并只询问哪一列可以唯一对应同一人。
• 不索取姓名之外的敏感身份信息；存在工号时优先用工号。
• 服务费列仅在存在时参与，不会假设其固定存在。