离职前十二个月平均工资 · 计算与举证
> 子剧本：本技能可独立使用；若你已在用民商事诉讼主控流程，可作为「法律研究 / 文书起草」阶段的子剧本被调用，不依赖任何外部技能。
> 适用范围：劳动争议中一切以「离职前 12 个月平均工资」为基数的计算。
>
> ⚠️ 调用前置（安装校验 · 交付双方都须确认）
> 1. AI 侧：处理相关请求前先确认自身已加载本技能（name: severance-wage-base）。未加载时应立即告知用户"该技能未安装、需先安装"，不得凭通用知识作答——地方口径规则库、依据强制与阻断纪律都在技能内，脱离技能只能产出无出处的通用回答。
> 2. 用户侧：把 ui/计算向导.html 或 task.json 交给他人 / 另一个 AI 经办前，先确认接收方已安装。安装位置：~/.workbuddy/skills/severance-wage-base/（Windows：C:\Users\<用户名>\.workbuddy\skills\severance-wage-base\），放好后重开对话生效。技能包内应同时含 SKILL.md、references/、data/、scripts/、ui/——缺项即为分发不全。
> 3. 校验方法：直接问接收方 AI「你装了 severance-wage-base 这个技能吗？」，已安装会报出技能名与版本。
> 4. 话术：向导页「⓪ 交付前置」条内置「复制安装确认提示语」按钮（对应 installPromptText()），复制后粘给接收方即可。
零、八条计算红线（不可绕过）
| # | 红线 | 落地方式 |
|---|---|---|
| 1 | 未选用工所在地不计算 | 地区为必填项；缺则阻断返回，禁止"默认全国口径" |
| 2 | 每条判定强制挂依据 | 结论必须附 basis（文号/案号）＋level；无 basis 的规则不生效 |
| 3 | 无本地依据则停算 | 该地对某争点无明文时，输出"无本地依据 · 待核"，并列候选口径及来源，不代为选择、不套用外地口径 |
| 4 | 三口径并列 | 应得工资／个税申报／银行实发同时输出，差异逐月标注，不擅自择一 |
| 5 | 地方数据用前即时检索 | 社平工资、最低工资不预置固定值；每次计算前即时检索，注明适用年度＋公布文号＋检索日期。缺项即阻断校准，不得用往年值顶替 |
| 6 | 用户只答最少必要问题＋交材料 | 解析证据、自动制表、检索地方标准、判定与计算、出文档全部由 AI 承担。禁止要求用户手工录入逐月明细、禁止要求用户自己去查社平/最低工资（详见〇之二） |
| 7 | 转办前确认接收方已装本技能 | 凡以「任务包 / 向导页 / 结果文件」形式把工作转交另一个 AI 或他人，必须先提示安装 severance-wage-base。任务包只说明"要算什么"，算法与规则在技能里；接收方未装技能，不得直接采信其结果 |
| 8 | 地方特色前置（2026-09-23 新增） | 劳动法地方差异可达结论反转（合法 vs 违法），非"略有不同"。故用工所在地为最高前置项：未选定即阻断，禁止以"全国通用口径"顶替（与红线 1 同源，此处升格为原则）。三层适用顺序：经济特区法规 → 省级地方性法规 → 设区的市地方性法规 → 部门规章 → 法律/行政法规，冲突时优先更具体、层级更高者。深企必叠加特区立法：《深圳经济特区和谐劳动关系促进条例》第12条（制度与劳动合同冲突，优先适用劳动合同）、第16条（经济处分 ≤ 当月工资30%、不重复处分、≥特区最低工资）；《深圳市员工工资支付条例》第23条（病假工资双标准取高）。地方中院《裁判指引》《解答》《纪要》不是我国法律渊源，不得作裁判依据直接引用，仅作说理参考，引用须连文件性质 + 文号（如深中法发〔2015〕13号）。地方法规经多次修正后条号整体位移，商业数据库常未同步，引用前须回地方人大常委会公报/政府公报的"重新公布全文"定位 |
依据可信度三级（写入结论时必须标注）
| 等级 | 含义 | 能否单独支撑结论 |
|---|---|---|
| 🅰 | 官方发布页原文（政府/法院/税务/人社/人大官网的条文原文） | 可以 |
| 🅱 | 官方渠道引用原文（法院、人社官网在裁判文书或答复中转引的地方文件） | 可以，须注明"转引" |
| 🅲 | 仅多源一致转述，未获任何官方发布页 | 不可，须标"未获官方发布页" |
> 红线 3 的执行纪律（本技能执行纪律）：案件实证方法可写入本技能作为方法范例，但计算时必须根据受理地的具体规定与做法（须有依据）取口径，不得生硬套用范例结论。
> 执业红线：地方高院《解答》《会议纪要》《裁判指引》不是我国法律渊源，不能作为裁判依据直接引用，只能作说理参考；引用时须连文件性质与文号一并注明。
〇之二、两种交互方式（启动时先定，用户只做两件事）
> 本技能的分工铁律（红线 6）
> 用户只负责：① 回答最少必要问题（≤4 问） ② 交出证据材料（文件夹 / 文件）。
> 其余全部由 AI 完成：解析工资清单·个税清单·银行流水·社保公积金 → 自动生成 12 个月三口径比对表 → 检索当地社平×3 与最低工资（带文号） → 判定加回/剔除 → 计算 → 出《工资数额比对说明表》与《计算说明》。
> 严禁：让用户手工录入逐月工资明细；让用户自己去查社平工资 / 最低工资；让用户填加回/剔除项与依据。
交互①：HTML 向导页（可视化、适合有较多证据文件）
打开 ui/计算向导.html（本地单文件、断网可用、不上云）。页面顶部固定显示⓪ 交付前置提醒（安装校验／3 步安装法／复制提示语），用户只走四屏：
① 选任务类型 → ② 只填事实（用工所在地＋入职日期＋解除/终止日期＋情形勾选） → ③ 交证据（填证据文件夹路径＋按类登记） → ④ 生成任务包 task.json。
> ★ 界面只采集事实，判断全部归 AI（v1.1.0 起）
> 第 ② 屏只收日期与勾选：入职日期、解除/终止日期、所在地、请求类型、情形。页面上不出现任何需要用户自己算的项——
> 不填「工作年限几年几个月」（那是判断），不填「补偿月数」，不填加回/剔除项，不填社平与最低工资。
> 任务包以 service:{start,end} 传递起止日期，另带 judgement_note 明确声明"页内未做任何计算或折算"。
> 年限与月数一律由 AI 侧算：service_span() 据起止日期算出「满 X 年 Y 个月」，再交 n_months_from() 按《劳动合同法》第 47 条折算出补偿月数。
> 理由：让用户填「5.42 年」等于把第 47 条的折算判断推给用户，一旦用户填错（如按 5.42 个月直乘）整个基数结论作废；填日期是可核验的事实，填年限是可能出错的判断。
> years（小数年限）/ n_months（直接给月数）保留为兼容字段，优先级：n_months > service > years。
> 第 ④ 屏内置「先确认接收方 AI 已安装本技能」红色提醒：任务包只说明"要算什么"，算法与规则在技能里。task.json 的 skill 字段已写入 required: true 与安装路径，ask 字段首句即为安装确认要求——接收方 AI 读到任务包第一件事就是自检技能；若其反馈未安装，须先装再办。
AI 收到 task.json 后按 5 步交付：
| 步 | AI 动作 | 工具 |
|---|---|---|
| 1 | 解析证据：读写工资清单 / 个税清单 / 银行流水 / 社保公积金，抽出每月三口径 | scripts/build_result.py |
| 2 | 自动对齐：个税「税款所属期」＝实际发放月，与「工资所属月」常差 1 个月；脚本自动试偏移并归位，差异逐月标注 | 同上（align_offset） |
| 3 | 检索地方标准：当地上年度职工月平均工资×3、最低工资，带适用年度＋公布文号＋检索日期，回填 task.local |
联网检索官方源 |
| 4 | 判定与计算：欠薪差额加回、非正常出勤月按受理地规则处理，出基数与补偿额 | calc_severance_base.py |
| 5 | 回填结果：产出 result.json（含三口径表、加回/剔除、上下限来源、依据回溯、阻断/待核清单、report_md），用户在向导页「⑤ 查看 AI 计算结果」载入即见 |
— |
# 典型调用
python scripts/build_result.py --task task.json --evidence-dir "<证据文件夹>" --out result.json
# 若三口径已提成 CSV：--due due.csv --declared tax.csv --paid bank.csv
脚本三级抽取策略（可靠度递减，低可靠一律记入 manual_required，绝不静默采信）：
① 表头关键词命中列 → ② 按列统计定位「月份列＋数值列」 → ③ 行内剔除月份子串取最大合理值（标 low）。
交互②：AskUser 问答（对话内、不开页面）
用一次 AskUserQuestion 把 4 问问完（不超过 4 项，每项附推荐答案）：
- 用工所在地（省／市）——决定全部地方口径。⭐必答
- 入职日期——起算点，AI 据此算年限。⭐必答（只问日期，不问"几年几个月"）
- 解除 / 终止日期——决定 12 个月窗口与年限终点。⭐必答（同样只问日期）
- 请求类型 N / 2N / N+1 ＋ 是否存在欠薪月份、非正常出勤月份、年终奖、第三方代发等情形（勾选即可，细节由 AI 核实）。⭐必答
> 问法纪律：第 2、3 问一律只收日期。不得问用户"工作年限多少年""N 是几个月"——年限折算属专业判断，由 AI 依第 47 条完成；用户答错或答不出都不应成为交付障碍。
答完后，AI 主动索要证据（一句话说明要哪 5 类、能拿几类拿几类），随后按交互①的第 1–5 步执行，并主动汇报：三口径月均、基数、补偿额、每一条依据、阻断与待核清单。
交互③：仅咨询（不建表、不收材料）
只要一个「答案」时走这条：直接按本技能规则解答。但不得省略效力核验——回答前先确认所引法源现行有效，已废止的当场内联标注〔已失效〕及依据；逐条挂文号并标 🅰/🅱/🅲；按受理地分述地区差异。
咨询模式的纪律（强制）：
1. 先核验、后作答——凡引用法律、行政法规、部门规章、地方文件、税务文件，均须先确认其现行效力，不得凭印象作答；
2. 已废止或状态矛盾的（如劳部发〔1994〕481号：人社部官网仍标"有效"，但 2017-11-24 第五批清理目录已"宣布废止"）须内联标注并说明依据；
3. 地方文件须注明文件性质（解答/纪要/指引/裁判决/答复）与文号；🅲 级（无官方发布页）不得单独支撑结论；
4. 答复末尾附核验日期（本次核验时点），便于日后复核是否已变。
一、五步计算法
| 步 | 动作 | 关键点 |
|---|---|---|
| 1 | 锁窗口 | 解除/终止之日前推 12 个月；先锁定统计口径——按「工资所属（劳动）月」还是「实际发放月」。两口径结果可能不同，须提前选定并预案对方攻击。⚠️ 解除当日落在月中时，窗口应止于「解除月的前一完整劳动月」（广东口径①，见 GD-05）；解除当月不满整月另作工资差额项单列，不并入基数 |
| 2 | 定口径 | 确定"月工资"包含哪些项目（A 基数本体，见 02） |
| 3 | 补差额 / 剔非正常月 | 欠薪月份按应得工资加回差额；非正常出勤月按受理地规则决定是否剔除。⚠️ 两步方向相反，切忌混淆 |
| 4 | 校上下限 | 低于当地最低工资→保底；超当地上年度职工月平均工资 3 倍→封顶，且该情形下年限≤12 年。数据须用前即时检索，见下节 |
| 5 | 出结论 | 并列三口径数值＋逐条依据回溯＋待核项清单 |
步 5 执行细则：补偿月数必须按第 47 条折算，不得直接用年限小数乘基数
> 高频致命错误：把「工作 5.42 年」直接写成 基数 × 5.42。正确做法是按《劳动合同法》第四十七条第一款折算为月数：每满一年一个月；六个月以上不满一年按一年；不满六个月支付半个月。
>
> | 输入年限 | 折算月数 | 说明 |
> |---|---|---|
> | 5.42 年（＝5年5个月） | 5.5 个月 | 剩余不满六个月→半个月 |
> | 5.50 年（＝5年6个月） | 6 个月 | 六个月以上不满一年→按一年 |
> | 4.70 年（＝4年8个月） | 5 个月 | 同上 |
>
> 脚本已内置：n_months_from(years, n_months, service)。给 service:{start,end} 起止日期可精确到天；task.json 若同时给出 years 与 service，以 service 为准。
>
> 计算式一律写作「基数 × N 个月」，并在结论旁注明折算依据，便于对方复核。
步 4 执行细则：地方数据「用前即时检索」（不预置固定值）
本技能不预置社平工资与最低工资的历史数值——各地数值逐年变动、口径不一，预置值极易被错用。每次使用前按下表即时检索：
| 项 | 要求 |
|---|---|
| 检索时点 | 计算当日 |
| 必备字段 | 数值 ＋ 适用年度 ＋ 公布文号 / 官方发布页 ＋ 检索日期 |
| 口径辨析 | 社平须辨明是「城镇非私营单位在岗职工平均工资」还是「全口径城镇单位就业人员平均工资」，按当地公布口径取数，不得跨口径混用 |
| 禁止沿用 | 往年值、邻近地区值、其他口径值 —— 宁可标「待核」，不得顶替 |
| 缺项后果 | 计算器对该步阻断，并输出检索指引（去哪查、搜什么关键词） |
| 留痕 | 使用后可将检索结果回填 data/local-wage.yaml 的 retrieval_log，并注明检索日期 |
检索入口（官方源）：各地人社局官网「统计数据 / 工资指导」栏目 · 各地统计局年度统计公报 · 人社部官网「最低工资标准情况」专栏 · 各地税务局个税政策栏目。详见 data/local-wage.yaml。
二、加回 vs 剔除：三种情形必须分流（本技能最易错点）
| 情形 | 处理 | 依据 |
|---|---|---|
| ① 单位欠付/克扣工资 | 加回差额（按应得工资口径） | 实施条例第27条；深劳人仲案【2023】11980号（核算公式明写"加上前述工资差额核算"）；南昌中院2026年黄某案 |
| ② 非正常出勤（病假/医疗期/待岗/停工留薪/产假） | 视受理地规则：浙江、陕西倾向剔除；最高院不剔除 | 浙高法民一〔2014〕7号第11条；(2024)陕民申1674号；(2023)最高法民申2918号 |
| ③ 劳动者主动降薪规避封顶 | 不予支持，按原标准 | 佛山中院(2025)粤06民终16311号 |
> 不要把 ① 和 ② 混为一谈：①是单位违法，差额必须加回；②是劳动者客观上未提供正常劳动，才存在"要不要剔除"的地方分歧。
三、十种口径对照（同一句话，十种算法）
| # | 口径 | 基数 |
|---|---|---|
| ① | 经济补偿 N | 前 12 个月平均应得工资 |
| ② | 赔偿金 2N | 同①×2，同受三倍封顶＋12年；计算年限自用工之日起（不分段） |
| ③ | 代通知金「+1」 | 上一个月工资标准 |
| ④ | 未休年休假工资 | 前 12 个月剔除加班工资后平均 ÷ 21.75 |
| ⑤ | 工伤「本人工资」 | 前 12 个月平均月缴费工资（300%/60% 双限） |
| ⑥ | 停工留薪期「原工资」 | 前 12 个月月平均工资（含不含加班费各地不同） |
| ⑦ | 生育津贴 | 单位上年度职工月平均工资 |
| ⑧ | 二倍工资 | 当月应得工资（各地是否含加班费不同） |
| ⑨ | 竞业限制补偿 | 前 12 个月平均工资 ×30% |
| ⑩ | 经济补偿个税 | 当地上年职工平均工资 ×3 以内免征 |
详见 references/04-multi-baseline.md。混用即错。
四、文件索引
| 文件 | 内容 |
|---|---|
references/01-national-law.md |
全国法源逐字原文 + 核验状态 |
references/02-issues-taxonomy.md |
计算争点 A–F 分类（含 A11 差额加回） |
references/03-local-standards.md |
地方口径横向对比表（分省，含文号+条款） |
references/04-multi-baseline.md |
十种口径对照 + 易错点 |
references/05-evidence-checklist.md |
证据清单 + 举证责任 + 八类瑕疵 + 三口径比对法 |
references/06-verification-log.md |
有效性核验记录（含 481 号文矛盾、🅲 级清单） |
data/rules.yaml |
地区规则库（每条带 basis） |
data/local-wage.yaml |
地方工资数据即时检索指引与检索留痕（不预置固定值） |
scripts/calc_severance_base.py |
计算器（地区驱动 · 阻断式） |
scripts/build_result.py |
证据自动解析 / 自动对齐 / 计算 → result.json：读证据目录或三口径 CSV，自动定位列、自动归位月份错位、调计算器、产出可被向导页载入的结果文件 |
ui/计算向导.html |
交互式向导页 v3.1：本地单文件、离线可用。顶部「⓪ 交付前置提醒」＋四屏——选任务类型 → 只填事实（所在地＋入职日期＋解除/终止日期＋情形勾选，页内不做任何计算与折算） → 交证据（填目录＋分类登记）→ 生成 task.json（含 service{start,end}、judgement_note、skill.required 与安装确认前置句）；处理完回填 result.json，在「⑤ 查看 AI 计算结果」载入即见三口径表、计算过程与依据回溯 |
五、交付纪律
- 分析类输出前 500 字内含 AI 辅助声明；不承诺胜负与判赔数额。
- 🅲 级依据不得单独支撑结论；无依据即标"待核"，不代为选择口径。
- 过程稿不默认输出 PDF；修订类输出带「修订版＋清洁版＋修订说明」。
- 涉及案件材料的计算全程本地，不上云。
- 咨询模式：答复前须核验所引法源现行效力，末尾附核验日期；不得以未经核验的口径作答。
- 分工纪律（红线 6）：交付前自检——是否让用户手工录了逐月明细？是否让用户自己去查社平/最低工资？是否为用户省事而猜了数？三者任一为"是"，即返工。
- 自动抽取的可靠性标注：
build_result.py若以低可靠策略（行内取最大合理值）抽数，结果必入manual_required，须逐月人工核对原始凭证后方可使用。 - 转办前置校验（红线 7）：以任务包 / 向导页 / 结果文件把工作转交他人或另一个 AI 时，交付动作的第一句必须是安装提示；接收方反馈"未安装"时，应暂停并给出安装路径，不得让其以通用知识替代技能规则继续处理。
- 差额公式全案统一：工资差额一律写「应得工资 −（实发 ＋ 当月个税 ＋ 社保公积金个人）」（毛口径，与「应发工资」对齐）。另一种写法「应得 − 实发」未扣除已代扣项，会虚高，二者差值恰为当月个税与社保公积金个人之和，混用即出现两版数据打架。改口径须同步改所有关联表。
- 月数写法：结论一律写「基数 × N 个月 ＝ 金额」并附折算依据，禁止出现「基数 × 5.42」这类年限小数直接相乘的写法（见「步 5 执行细则」）。
- 窗口口径须留痕：
build_result.py在labor_month下默认止于解除月的前一完整劳动月（trim_partial_end_month，可用task.window_end覆盖），并自动写入一条窗口口径待核，提示受理地另一说；该待核不得删除，须随结果一并交付。 - 界面与问卷只采集事实（v1.1.0 起）：向导页第 ② 屏与 AskUser 问卷只收日期、所在地、情形勾选——不收工作年限、不收补偿月数、不收加回/剔除项、不收社平与最低工资。任务包以
service:{start,end}传起止日期，并带judgement_note声明"页内未做任何计算或折算"。只要页面上出现"请填写工作年限/N 个月"这类需要用户自己算的项，即为违规，须返工。 - 「年限」与「乘数」必须分离：由日期算出的「满 X 年 Y 个月」（
result.service_years，如 5.33）仅供展示，绝不可作乘数；乘数一律取按第 47 条折算后的result.n_months（如 5.5）。凡出现「基数 × 5.33」即错。
六、前置确认（Grill · 启动前必问）
先定交互方式，再只问最少必要的问题。 不要一口气问成一份问卷——用户只需要回答机器问不出来的那几项。
第 0 问（决定后续全部动作）：走 HTML 向导页（可视化、适合证据文件多）／对话内问答（AskUser 一轮问完）／仅咨询（不建表）。
「要算结果」时的最少必要问题（就这 4 问，一次问完，每问附推荐答案）：
| # | 问题 | 为何必须问 |
|---|---|---|
| 1 | 用工所在地（省／市） | 决定全部地方口径，机器问不出 |
| 2 | 入职日期（只填日期，不问"几年几个月"） | 起算点，AI 据此算年限并折算 N 的月数 |
| 3 | 解除 / 终止日期（只填日期） | 决定 12 个月窗口与年限终点 |
| 4 | 请求类型 N / 2N / N+1 ＋ 是否存在欠薪月份、非正常出勤月、年终奖、第三方代发等情形（勾选即可） | 决定争点分流；细节由 AI 核实 |
以下各项 AI 自己查、自己算，不问用户：
工作年限与补偿月数（由入职/离职日期算年限、按第 47 条折算月数）、窗口统计口径（默认按劳动月，有证据后按证据说）、逐月三口径数据（由证据解析）、加回/剔除项与依据（按受理地规则判定）、社平工资与最低工资（按官方源即时检索并注文号）、举证责任分配。
（旧版方案中「工作年限填几年几个月」「数据来源覆盖月份」「地方数据是否已检索」三项，属判断或 AI 自查项，已从用户问卷中移除；年限与月数改由 service 起止日期算出。）
