技能介绍

要解决的问题

算工资的人每月都要面对至少四张表：考勤汇总、社保明细、税款计算和上月工资汇总。手工合并慢是一方面，更麻烦的是规则散落在经验里——计薪天数填哪一列、社保个人部分怎么取、部门小计插在哪一行，全靠人记。一旦表结构或月份对不上，整张表的公式都会错位。这个技能把合并与计算逻辑收敛成一个 Python 脚本（scripts/main.py），Skill 负责调度执行，把重复劳动交给代码。

核心能力与工作流程

核心逻辑已实现为脚本，Skill 负责找文件、确认月份、执行和呈现结果：

输入识别：自动匹配工作区内的四类文件，文件名需包含「考勤汇总」「社保」「税款计算」或「工资薪金」「工资汇总表」等特征，支持 .xlsx 与 .xls
月份确认：优先询问用户目标月份，未指定时尝试从文件名推断
脚本执行：在目标目录运行 python scripts/main.py，可用 -a/-s/-t/-p 显式指定四个输入，-m 指定月份，-o/-d 控制输出路径与工作目录
结果呈现：生成 {月份}工资汇总表.xlsx，展示文件并口头总结员工数、部门数与数据缺失项

字段映射和公式定义集中在 references/mapping.md，例如考勤对应 F（计薪天数）到 K（出勤）、社保对应 AB 到 AE、个税代扣在 AH、工资结构在 N 到 S。缺失数据标记为 error，员工按部门分组并插入小计行。

适用边界与注意点

公式列不会立即出值：绩效工资、考勤扣款、小计、应发合计、社保小计、实发金额都是公式，必须在 Excel 中打开才会计算，用脚本直接读输出文件可能拿到空值
输出表尾带有提醒区块：签字行下方空两行后包含公式列说明和 error 标记说明，属于设计的一部分
Windows 编码坑：必须在 PYTHONIOENCODING=utf-8 环境下运行脚本，否则中文控制台输出会乱码
依赖明确：Python 3.13 + openpyxl + xlrd（后者用于读 .xls），首次使用前需安装
文件不全会卡住：四个输入缺任何一个，技能会停下来询问补充；表头列位置与 mapping.md 不符时，可能需要调整映射规则