蚂蚁工资条年终奖个税智能优化器

年终奖发放的“临界点陷阱”与预算分配难题

在年终奖发放季，HR 和财务团队常面临一个悖论：为了避税而调整奖金金额，却可能触发税率跳档，导致员工税后所得不增反降（即“临界点陷阱”）。此外，当公司年终奖总预算固定时，如何在不同职级、不同收入水平的员工之间分配这笔资金，才能使整体税后收益最大化，是一个缺乏自动化工具难以快速求解的复杂问题。手动测算不仅耗时，且难以穷举所有可能的发放组合。

双轨计税测算与约束优化工作流

该 Skill 将年终奖个税测算与优化流程工程化，通过以下核心步骤解决上述问题：

• 政策与数据校验：调用 validate_policy_year() 确认纳税年度与适用地区。通过 scripts/validate_import.py 读取 .xlsx 或 .csv 文件，自动识别表头并映射字段，对冲突数据进行阻断而非静默猜测。
• 双轨计税计算：使用 scripts/calculate_bonus_tax.py 同时计算“单独计税”与“并入综合所得”两种方式。底层采用 Decimal 进行精确计算，避免浮点数误差。
• 多目标约束优化：scripts/optimize_bonus.py 支持 MAX_EMPLOYEE_AFTER_TAX（员工税后最大）、MIN_COMPANY_COST（公司成本最小）及固定总预算等多种优化目标，寻找合法合规的最优分配方案。
• 结构化结果导出：支持导出包含 9 个工作表的 Excel 明细，或通过 scripts/json_export.py 输出结构化 JSON，直接对接蚂蚁工资条等下游薪酬系统。

适用边界与合规底线

该工具定位为企业内部测算与辅助决策引擎，不替代专业财税人员的审核。

• 严格触发熔断：当政策年份未明确、员工匹配存在歧义、累计收入可能重复计算，或试图将已发放奖金纳入调整范围时，工具会立即停止优化并生成“待核实测算”。
• 守住合规底线：严禁通过虚构收入、拆分奖金或变更收入性质来规避纳税。所有优化建议均要求可解释、可复核，且绝不覆盖用户的原始数据文件。