Python 處理員工薪酬平均工資計算：AI 輔助 HR 效率升級指南

在香港，中小企業（SME）的 HR 部門經常面臨繁瑣的薪酬計算與稅務合規挑戰。特別是在計算「平均工資」（Average Daily Wage, ADW）時，處理格式不一的 Excel 表格往往耗費大量時間。本文將介紹一個強大的開源專案：HK-Human-Resources-Skills，這是一個專為 AI 代理（AI Agents）設計的工具庫，旨在透過自動化流程解決 HR 操作難題。

什麼是 HK-Human-Resources-Skills？

這不僅僅是一堆腳本，這是一個 Agent Skill 專案。它透過 SQLite 資料庫與 CLI 腳本，將 HR 的作業流程標準化。你可以將其與 Cursor、Claude Code 或其他 AI 助理結合，讓 AI 直接執行複雜的數據查詢與計算任務。

核心模組功能介紹

該專案涵蓋了香港 HR 常見的六大核心場景：

• ADW 薪酬模組：支援讀取不同格式的 Excel，自動推斷欄位映射並進行 ADW 計算，產生 CSV 報表。
• 員工管理 (EMPLOYEE)：完整的員工檔案 CRUD 管理，支援唯一識別碼與搜尋功能。
• 生命週期管理 (LIFECYCLE)：自動化入職與離職清單，追蹤各項任務的完成狀態。
• 合規性記錄 (COMPLIANCE)：針對合約有效期與工作資格進行數位化追蹤。
• 請假系統 (LEAVE)：與 hrsys_web_v2 結構相容，管理請假申請、補假及審批狀態。
• IR56B 準備：提供稅務申報所需的資料欄位檢查與 Excel 匯出功能。

如何開始使用

1. 安裝環境

確保已安裝 Python 3.10+，接著在專案根目錄執行：

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. 初始化資料庫

執行初始化腳本，系統會自動建立 SQLite 資料庫檔案（預設於 ~/.hkhrcore/hrcore.db）：

python scripts/init_employee.py

AI 輔助工作流：從 ADW 計算開始

這套工具的強項在於其「輸出契約」。所有腳本皆輸出結構化的 JSON，這使得 AI 助理能完美解析結果。例如，若要處理薪酬，你可以對 AI 這樣下指令：

• 「幫我計算該部門所有員工的月度 ADW 薪資，並標示出任何計算警告。」
• 「將離職員工的任務清單匯出，並檢查是否有未完成的 IT 存取權限移除。」

重要安全提示

HR 資料包含極敏感的個人識別資訊（PII）、薪資與稅務數據。在使用此工具時，請務必遵循以下建議：

• 優先使用本地 LLM：避免將數據傳送至外部公開的 AI API。
• 權限管理：嚴格限制資料庫檔案的檔案系統存取權限。
• 僅作輔助：此工具提供操作支援，並非法律或稅務諮詢，所有計算結果應由專業人員覆核。

透過整合這套 Python 工具，企業可以大幅降低人為錯誤，並將重複性的文書工作交給 AI 自動化處理。立即訪問 GitHub 專案頁面 開始部署你的 HR 數位轉型計畫！