Files
query-payslip-default/TUTORIAL.md
skill-dev 3db196e49d feat: 工资查询助手首版 v1.0.105
基于 skill-template 脚手架开发,包含:
- payroll_config(费率配置,可编辑)+ payslip_snapshots(解析历史,只读)2 张业务表
- 全国默认 + 北上广 4 套费率(社保/公积金/个税起征点/7 级税率表)
- 5 个业务 Action:calculate-payslip-simple / calculate-payslip-full / explain-term / view-config / edit-config
- 个税累计预扣法计算,支持多月历史累加
- 20 个薪资名词库(社保/公积金/个税/全勤/加班费等)
- 完整市场文档(README/TUTORIAL/DEMO/CHANGELOG)
- 296 测试全部通过
2026-09-07 17:02:05 +08:00

2.2 KiB
Raw Blame History

本技能做什么

粘贴工资条或输入金额,帮你核算应发/扣除/实发,核对差异,解释名词,估算个税。

开始前

  • 准备好基本工资金额(必填)
  • 准备好工资期间如 2026-08(必填)
  • 可选:工资条各项金额、实发金额(用于核对)

入口一:对话任务

直接对助手说你的情况,例如:

"帮我核算工资,基本 8000,期间 2026-08,餐补 440,社保 640,公积金 560,自报实发 6260"

助手会自动选 Action 并返回:

  • 应发合计 / 扣除合计 / 实发(计算)
  • 核对结果:一致 or 差异金额
  • 估算项标注"仅供参考"

入口二:数据管理

快速估算

  1. 打开「数据管理 / 解析历史」表
  2. 点工具栏「快速估算工资」
  3. 填:基本工资 + 工资期间 + 地区(可选)
  4. 提交 → 结果写入历史表,自动刷新

精确核算

  1. 点工具栏「精确核算工资」
  2. 填全字段(应发项 + 扣除项 + 期间)
  3. 缺失的扣除项自动按费率估算
  4. 提交 → 完整明细 + 核对差异

查看历史

「解析历史」表按时间倒序,可看每月的应发/扣除/实发/核对结果。

改费率(管理员)

  1. 打开「费率配置」表
  2. 双击数值单元格编辑
  3. 选地区(default / beijing / shanghai / guangzhou)

入口三:定时任务

不适用。本技能为即时查询工具,无定时需求。


主能力对照表

能力 入口 怎么触发
快速估算 对话 / 数据管理 toolbar 基本工资+period → 按费率估
精确核算 对话 / 数据管理 toolbar 全字段 → 精确计算+核对
名词解释 对话 "解释一下速算扣除数"
查看费率 数据管理 / 技能详情 view-config
编辑费率 数据管理 row 双击编辑(管理员)

常见卡住怎么办

估算个税和工资条对不上?

累计预扣需历史数据。首次使用按单月算,仅供参考。补录前几个月后重算更准。

费率不对?

管理员在「费率配置」表改数值。地区 default=全国默认。

没有我所在地区?

选 default(全国默认)。后续版本会扩展更多城市。