香港人力資源合規性追蹤系統：利用 AI Agent 自動化 SME 人事管理

對於香港的中小企業（SME）而言，處理繁瑣的人事行政與合規要求往往耗費大量時間。今天介紹的 HK-Human-Resources-Skills 是一個開源的 Agent Skill 項目，專為整合 AI Agent（如 Cursor Agent 或 Claude Code）而設計，讓 AI 能直接操作結構化的 HR 資料庫。

為什麼需要這套系統？

此系統採用 SQLite 作為核心，具備離線操作的特性，確保企業最敏感的員工資料（如薪資與個人身份資訊）保留在本地。該項目透過 Python 腳本提供標準化的 CLI 指令，讓 AI 助理能精準執行人事行政任務。

核心模組功能介紹

本系統將 HR 工作細分為多個模組，每個模組皆有對應的 schema 定義與處理邏輯：

• 員工管理 (EMPLOYEE)： 建立與維護員工主資料，支援員工編號與郵件地址的唯一性檢查。
• 生命週期管理 (LIFECYCLE)： 處理入職 (Onboarding) 與離職 (Offboarding) 的任務清單，並追蹤每項任務的完成狀態。
• 合規性追蹤 (COMPLIANCE)： 專門用於記錄與監控合約、工作資格等重要文件的有效期。
• 請假系統 (LEAVE)： 支援各類假別設定、請假申請流程以及補假 (Compensation Leave) 追蹤。
• 稅務準備 (IR56B)： 提供 IR56B 報稅資料延伸欄位，並包含自動化的「完備性檢查」，預先識別缺失資訊。
• ADW 薪資處理： 針對平均日薪 (ADW) 計算，支援從 Excel 匯入並進行自動化映射與報表產出。

如何設定與開始使用

1. 安裝環境

確保您的電腦已安裝 Python 3.10+，並於終端機執行：

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

2. 初始化資料庫

執行初始化腳本，建立所有模組所需的 SQLite 表格：

python scripts/init_employee.py

AI Agent 協作工作流

此專案的核心價值在於與 AI 助理的協作。建議的操作流程如下：

1. 任務分類： 請 AI 判斷需求，並呼叫對應模組（如：「請幫我查詢這位員工的合規記錄」 -> 對應 COMPLIANCE 模組）。
2. 指令預覽： 執行任何寫入動作前，要求 AI 顯示即將執行的指令。
3. JSON 輸出處理： 系統所有腳本均輸出標準 JSON 格式，方便 AI 進一步解析並轉換為易讀的總結報告。

資安提醒

由於人力資源資料包含高度敏感的個人隱私資訊，在使用 AI 處理此系統時，建議：

• 優先使用本地端運行的 LLM，避免將機敏資料傳輸至雲端 API。
• 嚴格限制資料庫檔案的存取權限。
• 本工具僅提供作業層面的支援，並非正式的法律或稅務諮詢方案。

立即訪問 GitHub Repository 開始體驗高效的 HR 自動化流程。