前言¶
HR 和薪酬专员日常要在 Excel、个税系统和各地社保政策页面之间来回切换：单人试算还好，批量核算和跨月核对时，公式版本、基数上下限一旦滞后，就容易算错或漏看异常。把「算五险一金与个税」「解析工资表」「两期差异标记」「政策查询」收进一个 Skill，可以在对话里用自然语言触发，并按场景落到对应脚本。下面介绍 SkillHub 上的 薪酬个税计算器（@user_fcba917f/salary-tax-calculator）能做什么、如何安装，以及官方资料中的典型用法。
这是什么¶
薪酬个税计算器是面向 HR 薪酬核算与审计的 Agent Skill，版本 1.0.0，来源为社区（community），分类 professional，由 user_fcba917f（SkillHub 页面标注维护者：EFU周博远）发布。标签标明 requires_api_key=false，使用时不依赖额外 API Key。
官方入口：
- API / 技能包：
https://api.skillhub.cn/user_fcba917f/salary-tax-calculator - SkillHub 展示页：
https://www.skillhub.cn/skills/user_fcba917f/salary-tax-calculator
它解决的核心问题：在 Agent 会话中输入工资相关数据或上传工资表，自动完成应发/实发测算、批量计算、两期对比与异常标记，并可联网或检索知识库查询社保公积金等政策，必要时生成可视化 HTML 报告。
核心功能¶
以下能力均来自官方 Skill 说明，按模块对应到技能内的 Python 脚本。
工资计算¶
输入税前工资、社保与公积金基数等，自动计算五险一金、个人所得税和实发工资。单人场景可直接走 tax_calculator.py。
异常检测¶
上传或提供两期工资表（例如上月与本月），解析后自动对比差异，标记异常波动。流程为 salary_parser.py 解析，再由 anomaly_detector.py 对比。
联网与知识库查询¶
支持联网搜索最新社保基数、公积金比例等政策；也可通过知识库检索回答政策类问题（官方示例含「2026 年北京社保基数上下限」一类问法）。
报告生成¶
可生成 HTML 报告，内容包括工资构成饼图、个税阶梯图、异常波动仪表盘等，由 report_generator.py 产出。
安装与启用¶
Skill 遵循通用 SKILL.md 格式。在 SkillHub 上安装时，官方建议让 AI 按安装文档操作，或直接引用坐标 @user_fcba917f/salary-tax-calculator。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需要 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装说明全文：https://skillhub.cn/install/skillhub.md。
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 实际读取的 skills 目录；若装到默认 ./skills/ 而 Agent 未配置该路径，技能不会被识别。
skillhub install @user_fcba917f/salary-tax-calculator --dir <你的 skills 目录>
常见路径（以 SkillHub 文档为准，按你当前客户端选择其一）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可在对话中发送官方提示词：「请根据 https://skillhub.cn/install/skillhub.md，安装 @user_fcba917f/salary-tax-calculator。」
经过上面的步骤，在对应客户端启用 Skills 后，即可在会话中用自然语言触发下文场景。
典型用法¶
用法来自官方「适用场景」表，可在 Agent 中用类似表述复现。
单人税后测算
触发示例：「北京月薪 25000，社保基数按实际，帮我算税后多少。」
处理方式：tax_calculator.py 直接计算。
批量实发
触发示例：「帮我算这个 Excel 里所有人的实发工资。」
处理方式：salary_parser.py 解析 → tax_calculator.py 批量计算。
月度差异对比
触发示例：「这是上个月和这个月的工资表，看看谁的变化比较大。」
处理方式：salary_parser.py 解析 → anomaly_detector.py 对比。
政策查询
触发示例：「2026 年北京社保基数上下限是多少。」
处理方式：联网搜索或知识库检索（以 Skill 实际联网/检索能力为准）。
报告输出
触发示例：「生成这份工资的详细报告。」
处理方式：report_generator.py 生成 HTML。
适用场景与注意¶
| 场景 | 适合谁 | 说明 |
|---|---|---|
| 单人/批量工资计算 | HR 核算、个人测算税后收入 | 依赖技能内置算法与基数规则；政策变动时宜配合联网查询核对 |
| 两期工资表审计 | 薪酬专员、财务审计 | 异常标记需结合业务原因人工复核，不宜单独作为合规结论 |
| 社保公积金测算 | HR、员工自助估算 | 各地比例以当地最新政策为准，查询结果建议对照官方文件 |
| 可视化报告 | 对内说明工资构成 | 输出为 HTML，便于本地打开查看 |
限制与注意：
- 社区来源 Skill，政策与税率更新节奏以维护者发布版本为准，关键发放前建议交叉验证。
- 批量与对比依赖工资表格式能被
salary_parser.py正确解析，表头或列名不统一时可能需在对话中说明字段含义。 - 无需 API Key，但联网查询仍受运行环境与 Agent 工具权限影响；无网络时政策类问题可能只能依赖技能内置知识库范围。
结尾¶
薪酬个税计算器把工资试算、表解析、两期异常检测、政策查询和 HTML 报告串成一条对话链路，适合把重复核算从表格公式里挪到 Agent 工作流。安装坐标：@user_fcba917f/salary-tax-calculator；说明与场景表见 SkillHub：https://www.skillhub.cn/skills/user_fcba917f/salary-tax-calculator，技能包地址：https://api.skillhub.cn/user_fcba917f/salary-tax-calculator。
