ee2a4d9e22
All checks were successful
技能自动化发布 / release (push) Successful in 15s
基于 skill-template 脚手架开发，包含： - 5 张业务表（教职工、请假政策、考勤日历、请假记录、假期余额） - 请假核算引擎（扣薪计算、审批层级判定、年假抵扣） - CLI 入口（import-employees / calculate-leave / render-html） - HTML 审批与扣薪报告生成 - 示例数据与完整测试套件（295 tests passed）
92 lines
2.4 KiB
Markdown
92 lines
2.4 KiB
Markdown
## 本技能做什么
|
||
|
||
按学校政策为教职工请假申请自动核算扣薪金额、审批层级，并更新考勤与假期余额，输出审批单与扣薪报告。
|
||
|
||
## 你将完成什么
|
||
|
||
1. 导入教职工
|
||
2. 确认请假政策与考勤日历
|
||
3. 请假核算（扣薪 + 审批层级 + 余额更新）
|
||
4. 按需生成报告
|
||
|
||
---
|
||
|
||
## 使用前准备
|
||
|
||
1. 已安装本技能
|
||
2. 打开数据管理，可见 **教职工 / 请假政策 / 考勤日历 / 请假记录 / 假期余额**
|
||
3. 教职工 JSON 放在：
|
||
|
||
```
|
||
{技能数据根}/input/教职工库/
|
||
└── 示例教职工.json
|
||
```
|
||
|
||
首次「初始化库」或健康检查会同步内置示例，并在政策与日历为空时写入 7 类示例政策与节假日。
|
||
|
||
---
|
||
|
||
## 入口一：数据管理
|
||
|
||
### 1. 导入教职工
|
||
|
||
1. 进入 **教职工**
|
||
2. 点 **导入教职工** → 选择 JSON 文件
|
||
3. 表中出现/更新教职工记录
|
||
|
||
### 2. 确认政策与日历
|
||
|
||
1. 打开 **请假政策**，检查各类假别的带薪天数、扣薪比例、审批阈值
|
||
2. 打开 **考勤日历**，确认法定节假日与周末已登记
|
||
|
||
### 3. 请假核算
|
||
|
||
在 **教职工** 表：
|
||
|
||
- **请假核算**：选择教职工行，填写假别、起止日期、是否附证件
|
||
|
||
系统自动计算工作日数、扣薪金额、年假抵扣、审批层级，并写入请假记录与假期余额。
|
||
|
||
### 4. 生成报告
|
||
|
||
在 **请假记录** 表：
|
||
|
||
- **生成请假报告**（导出 HTML）
|
||
|
||
---
|
||
|
||
## 入口二：对话任务
|
||
|
||
| 意图 | 示例话术 |
|
||
|------|----------|
|
||
| 导入教职工 | 「用示例教职工导入教职工库。」 |
|
||
| 请假核算 | 「给张教授核算 9 月 10 日到 25 日的病假。」 |
|
||
| 生成报告 | 「生成最近一次请假报告。」 |
|
||
|
||
---
|
||
|
||
## 定时任务
|
||
|
||
本技能**不需要定时任务**（请假核算为按需操作，未提供 cron 挂载）。
|
||
|
||
---
|
||
|
||
## 主能力对照表
|
||
|
||
| 能力 | 数据管理 | 对话 | 定时 |
|
||
|------|----------|------|------|
|
||
| 导入教职工 | 教职工 toolbar | 可 | 不适用 |
|
||
| 请假核算 | 教职工 toolbar | 可 | 不适用 |
|
||
| 生成请假报告 | 请假记录 toolbar | 可 | 不适用 |
|
||
|
||
---
|
||
|
||
## 常见卡住怎么办
|
||
|
||
| 现象 | 处理 |
|
||
|------|------|
|
||
| 教职工为空 | 先导入教职工 JSON |
|
||
| 未知请假类型 | 在请假政策表中配置该假别后重试 |
|
||
| 需证件报错 | 提供相关证明文件后勾选「附证件」 |
|
||
| 报告无数据 | 先完成一次请假核算 |
|