前言¶
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。
