工资汇总表生成 Skill
概述
从4个输入Excel文件自动生成工资汇总表。核心逻辑已实现为Python脚本（scripts/main.py），Skill负责调度和执行。
触发条件
当用户请求生成/制作工资汇总表、薪资汇总时触发。特征：
- 提到"工资汇总"、"薪资汇总"、"算工资"、"工资表"等关键词
- 工作区存在考勤/社保/税款等Excel文件
- 用户提供了文件路径并要求生成汇总
工作流程
1. 确认输入文件
检查用户工作区或提供的路径，确认4个输入文件都存在：
| 文件类型 | 文件名特征 | 格式 |
|---|---|---|
| 考勤汇总表 | 含"考勤汇总" | .xlsx |
| 社保明细 | 含"社保" | .xlsx |
| 税款计算表 | 含"税款计算"或"工资薪金" | .xls/.xlsx |
| 上月工资汇总表 | 含"工资汇总表" | .xlsx |
如果用户未明确指定，脚本会自动按文件名模式匹配。若某些文件缺失，询问用户补充。
2. 确认目标月份
询问用户目标月份（如"2026年5月"）。若用户未指定，尝试从文件名中推断。
3. 运行脚本
重要：Windows 下必须设置 PYTHONIOENCODING=utf-8，否则控制台中文输出会乱码。
在目标工作目录运行：
cd "<用户的工作目录>" && PYTHONIOENCODING=utf-8 C:/Users/xie/.workbuddy/binaries/python/versions/3.13.12/python.exe "<skill_dir>/scripts/main.py" -m "2026年5月"
可选参数：
- -a <path> 指定考勤表路径
- -s <path> 指定社保表路径
- -t <path> 指定税款表路径
- -p <path> 指定上月工资表路径
- -m "月份" 指定目标月份
- -o <path> 指定输出路径
- -d <dir> 指定工作目录
4. 呈现结果
脚本运行完成后：
1. 使用 present_files 展示生成的 {月份}工资汇总表.xlsx
2. 口头总结：员工数、部门数、数据缺失项（如有）
3. 输出表底部自动包含提醒区块（签字行下方空2行后），内容为公式列说明和 error 标记说明
4. 提醒用户：公式列（绩效工资/考勤扣款/小计/应发合计/社保小计/实发金额）需在Excel中打开才会计算
依赖
- Python 3.13 (openpyxl + xlrd)
- 首次使用前需安装：
pip install openpyxl xlrd
映射与公式规则
详细的字段映射和公式定义见 references/mapping.md。可在需要时加载。
关键规则摘要：
- 考勤→F(计薪天数)/G(病假)/H(事假)/I(未打卡)/K(出勤)
- 社保→AB(养老)/AC(医疗)/AD(工伤)/AE(失业)
- 税款→AH(个税代扣)
- 上月汇总→L(工资标准)/M(职级)/N-S(工资结构)
- 缺失数据标记为 "error"
- 员工按部门分组，部门间有小计行
