自動化計算香港月薪平均工資：利用 AI 代理高效管理 HR 流程

在數位轉型的浪潮下，香港中小企業的 HR 部門面臨著繁重的行政壓力。我們今天要介紹的 HK-Human-Resources-Skills 是一個極具前瞻性的開源專案。它不僅是一個工具庫，更是一個專為 AI 代理 (AI Agents) 設計的技能集（Skill project），旨在透過 Cursor Agent 或 Claude Code 等 AI 工具，無縫整合並自動化處理香港複雜的 HR 行政流程。

為什麼需要這個 AI 導向的 HR 工具？

傳統 HR 系統往往笨重且難以客製化。此專案透過 SQLite 提供輕量級的資料儲存，並藉由標準化的 CLI 腳本，讓 AI 能快速讀取、處理並輸出 JSON 格式的數據。這對於需要頻繁處理薪酬、僱員入職/離職及合規檢查的企業來說，極大提升了工作效率。

核心模組功能介紹

此工具箱涵蓋了香港 HR 作業的六大核心領域：

• ADW（平均工資計算）：這是本專案的核心亮點。它可以處理不同格式的 Excel 檔案，透過自動化的欄位對應與信心評分，協助您精準計算月薪的平均工資，並產生薪酬摘要與錯誤預警。
• 僱員管理 (EMPLOYEE)：建立 SQLite 僱員資料庫，支援員工資訊的增刪查改，並確保員工編號與郵件的唯一性。
• 生命週期 (LIFECYCLE)：自動化管理員工入職與離職的檢查清單（Checklist），並追蹤各項任務狀態。
• 合規追蹤 (COMPLIANCE)：針對合約有效期、工作資格等重要日期進行管理與監控。
• 假期管理 (LEAVE)：支援假期類型定義與申請流程（Pending/Approved/Rejected），與常見的系統結構相容。
• IR56B 準備：一鍵檢查稅務申報資料完整度，並產生 Excel 格式的申報準備檔案。

如何設定與使用

此專案設計為 AI-first，建議依照以下步驟啟動：

1. 安裝環境

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

2. 初始化資料庫

python scripts/init_employee.py

3. AI 工作流實踐

將此專案掛載於 AI 編輯器（如 Cursor）後，您可以直接對 AI 下達指令：

• 「幫我計算該員工的 ADW 薪資，並標示出任何計算警告。」
• 「檢查所有員工的 IR56B 資料，列出遺漏的欄位。」
• 「為新進員工建立 onboarding 任務清單並列出待辦事項。」

安全與合規提醒

HR 資料涉及個人隱私與公司機密，在使用 AI 處理此類數據時，請務必：

• 優先使用本地運行 (Local/On-device) 的大型語言模型。
• 避免將敏感個人資料上傳至公有雲 API，除非企業內部已通過資安審核。
• 此工具提供操作輔助，並不構成法律或稅務諮詢建議。

透過整合 HK-Human-Resources-Skills，您的企業可以將繁瑣的行政操作轉化為自動化的數位流程，讓 HR 專注於更具戰略價值的決策中。