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 测试全部通过
This commit is contained in:
skill-dev
2026-09-07 17:02:05 +08:00
commit 3db196e49d
205 changed files with 29927 additions and 0 deletions

78
DEMO.md Normal file
View File

@@ -0,0 +1,78 @@
---
demo_video_url: ""
---
## 演示一:快速估算
**输入**:基本工资 8000,期间 2026-08,地区 default
**助手执行**:`calculate-payslip-simple`
**输出**(节选):
```
应发合计:8000.00
- 基本工资:8000.00
扣除合计:1840.00
- 社保个人:800.00(按费率估算,仅供参考)
- 公积金个人:560.00(按费率估算)
- 个税:480.00(累计预扣估算,仅供参考)
实发工资:6160.00
📌 估算项仅供参考,非官方数据
```
---
## 演示二:精确核算 + 核对差异
**输入**:基本 8000,餐补 440,社保 640,公积金 560,个税 200,期间 2026-08,自报实发 6260
**助手执行**:`calculate-payslip-full`
**输出**(节选):
```
应发合计:8440.00
- 基本工资:8000.00
- 餐补:440.00
扣除合计:1400.00
- 社保个人:640.00
- 公积金个人:560.00
- 个税:200.00
实发工资(计算):7040.00
核对结果:不一致
- 用户自报:6260.00
- 计算实发:7040.00
- 差异:-780.00(用户少报 780)
⚠ 若实发不一致,建议联系人事/财务核对
```
---
## 演示三:名词解释
**输入**:"解释一下速算扣除数"
**助手执行**:`explain-term --term 速算扣除数`
**输出**:
```
速算扣除数
分类:个税
解释:为简化计算设定的扣除数,避免分级补差。
应纳税额 = 应纳税所得额 × 税率 - 速算扣除数
示例:应税 14000,10% 档,速算 2520 → 税额 = 14000×10%-2520 = 880
```
---
## 演示四:编辑费率(管理员)
**输入**:把北京的公积金比例从 12% 改为 11%
**助手执行**:`edit-config --config-key housing_fund_rate --region beijing --config-value 0.11`
**输出**:
```
已更新 housing_fund_rate(地区 beijing)
旧值:0.12
新值:0.11
```