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

81
TUTORIAL.md Normal file
View File

@@ -0,0 +1,81 @@
## 本技能做什么
粘贴工资条或输入金额,帮你核算应发/扣除/实发,核对差异,解释名词,估算个税。
## 开始前
- 准备好基本工资金额(必填)
- 准备好工资期间如 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(全国默认)。后续版本会扩展更多城市。