如何使用 SQLite 資料庫管理員工資料：HKHR-Skills 工具包介紹

對於香港的中小企業（SME）而言，HR 行政作業往往瑣碎且繁雜。為了提升效率，HKHR-Skills 應運而生。這是一個專門為 AI 助理（如 Cursor Agent 或 Claude Code）設計的 Agent Skill 專案，旨在透過輕量級的 SQLite 資料庫，協助開發者與 HR 管理人員自動化處理各種員工管理任務。

為什麼選擇 HKHR-Skills？

HKHR-Skills 的核心理念是將複雜的 HR 流程「模組化」，並透過 CLI 指令讓 AI Agent 能夠直接讀寫資料。它不僅僅是一個資料庫，更是一套為 Hong Kong HR 營運場景量身打造的自動化工具箱。

核心模組功能：

• 員工資料管理 (EMPLOYEE)：建立、搜尋與維護員工的基本資訊，支援員工編號與 email 唯一性校驗。
• 生命週期管理 (LIFECYCLE)：自動化處理入職（Onboarding）與離職（Offboarding）清單，並追蹤任務執行狀態。
• 合規性記錄 (COMPLIANCE)：儲存合約、工作資格等重要檔案的有效期限，協助行政人員掌握法規風險。
• 請假系統 (LEAVE)：支援假別設定、請假流程審批以及補假申請，並與常見的 HR 系統結構相容。
• 稅務準備 (IR56B)：針對香港稅務需求，提供 IR56B 檔案延伸、就緒狀態檢查及 Excel 報表匯出功能。
• 薪酬計算 (ADW)：利用 Excel 檔案自動推斷資料結構，並進行平均日薪（ADW）計算與報表產生。

快速開始與設定

本專案設計簡潔，只需 Python 環境即可快速部署：

1. 安裝需求

確保系統已安裝 Python 3.10+，並在專案根目錄執行：

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

2. 初始化資料庫

執行初始化指令，系統將自動於預設路徑建立資料庫：

python scripts/init_employee.py

如何結合 AI Agent 使用

HKHR-Skills 是為 AI 運作而生的。你可以透過以下流程提升工作效率：

• 情境分類：向 AI 說明你的需求（例如：「幫我產生這個月員工的 ADW 報表」）。
• 執行指令：AI 會自動選定相關模組（如 ADW），並執行對應指令。
• 安全預覽：在執行任何寫入動作前，請 AI 顯示預計執行的指令，確保資料安全。
• 資料解析：所有指令輸出均為標準 JSON 格式，方便 AI 快速轉譯為人類可讀的總結報告。

安全注意事項

由於 HR 資料涉及個人隱私與敏感薪酬資訊，建議：

• 優先在本地環境運行此工具。
• 避免將包含員工個資的檔案直接上傳至公開的 AI API。
• 請依照公司內部資訊安全政策管理資料庫檔案的存取權限。

現在就前往 GitHub 儲存庫 開始體驗吧！