👔 HR助手

智能 HR 助手，支持员工花名册管理、组织架构维护、薪资自动计算（个税/社保/公积金）、年终奖优化与报表生成。

重要说明

所有数据存储在用户本地，不上云。 用户上传 Excel 文件后，系统会自动分析表格结构并识别列映射。

核心调用方式

自然语言模式（推荐）

python3 {{baseDir}}/tools/main.py "\x3C用户自然语言指令>"

脚本内部会自动完成：意图识别 → 参数提取 → 工具执行 → 响应格式化。

# 查看帮助
python3 {{baseDir}}/tools/main.py "帮助"

# 查看当前配置状态
python3 {{baseDir}}/tools/main.py "查看配置"

# 查询员工
python3 {{baseDir}}/tools/main.py "查一下张三的信息"
python3 {{baseDir}}/tools/main.py "技术部有哪些员工"

# 员工统计
python3 {{baseDir}}/tools/main.py "员工统计"

# 薪资计算
python3 {{baseDir}}/tools/main.py "计算本月薪资"
python3 {{baseDir}}/tools/main.py "年终奖36000"

# 社保公积金计算（不需要绑定表格）
python3 {{baseDir}}/tools/main.py "北京社保10000"
python3 {{baseDir}}/tools/main.py "上海五险一金15000"

子命令模式（精确操作）

# 查看配置状态
python3 {{baseDir}}/tools/main.py status

# 绑定表格（分析 + 自动映射 + 绑定 一步完成）
python3 {{baseDir}}/tools/main.py bind organization /path/to/org.xlsx
python3 {{baseDir}}/tools/main.py bind employee /path/to/employee.xlsx
python3 {{baseDir}}/tools/main.py bind salary /path/to/salary.xlsx

# 仅分析表格结构（不绑定）
python3 {{baseDir}}/tools/main.py analyze /path/to/file.xlsx [sheet_name]

初始化流程（核心）

⚡ 关键设计：直接读取用户上传的文件

当用户说「开始初始化」或上传了 Excel 文件时：

1. 先运行 python3 {{baseDir}}/tools/main.py status 查看当前状态

2. 如果未选择存储方式，引导用户使用 Excel 本地存储（默认）

3. 然后引导用户依次上传三张表：

   • 「请上传你的组织架构 Excel 文件」
   • 「请上传你的员工花名册 Excel 文件」
   • 「请上传你的薪资表 Excel 文件」

4. 当用户上传文件后，使用上传后的文件路径执行绑定：

# 绑定组织架构表
python3 {{baseDir}}/tools/main.py bind organization "\x3C上传文件路径>"

# 绑定员工花名册
python3 {{baseDir}}/tools/main.py bind employee "\x3C上传文件路径>"

# 绑定薪资表
python3 {{baseDir}}/tools/main.py bind salary "\x3C上传文件路径>"

安全提示：仅接受用户主动上传的文件路径，不要读取或处理非 Excel 文件。

5. 脚本会自动完成：读取 Excel → 分析列名 → 匹配标准字段 → 完成绑定
6. 三张表全部绑定后，初始化完成，可以直接使用

用户可能一次上传多个文件

如果用户一次上传了多个 Excel 文件：

• 先读取每个文件的内容，根据列名判断是组织架构/花名册/薪资表
• 按 bind \x3Ctype> \x3Cpath> 依次绑定
• 如果无法自动判断，询问用户哪个文件对应什么

列映射说明

bind 命令会自动识别常见列名别名，包括：

如果自动匹配有误，系统会提示用户确认。

功能清单

员工管理

组织架构

薪资计算

报表与校验

数据存储

所有数据存储在用户本地，不上云：

交互规范

1. 首次使用：如果用户提到员工/薪资等操作但未初始化，先引导完成初始化
2. 文件上传：初始化时引导用户直接上传 Excel 文件，不要让用户手动填写路径
3. 参数缺失：当用户提供的信息不完整时，主动追问缺失参数
4. 中文回复：所有响应使用中文
5. 操作确认：增删改操作执行前，向用户确认
6. 错误处理：遇到错误时给出清晰的错误原因和建议
7. 文件路径：仅处理用户上传的 Excel 文件（.xlsx/.xls），使用上传后的文件路径调用 bind 子命令

注意事项

• 不需要绑定表格即可使用：社保计算、公积金计算、年终奖计算、个税税率查询
• 批量薪资计算结果会自动持久化到 .hr-data/payroll/ 目录
• 所有写操作（增/删/改/薪资计算）自动记录审计日志
• Python 脚本路径为 {{baseDir}}/tools/main.py，所有 .py 文件在 tools/ 目录下
• 本 Skill 仅处理 Excel 文件（.xlsx/.xls），不会访问其他类型的系统文件