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

82 lines
2.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## 本技能做什么
粘贴工资条或输入金额,帮你核算应发/扣除/实发,核对差异,解释名词,估算个税。
## 开始前
- 准备好基本工资金额(必填)
- 准备好工资期间如 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(全国默认)。后续版本会扩展更多城市。