feat: 初始化高校人事请假考勤技能 (process-leave-attendance-default)
All checks were successful
技能自动化发布 / release (push) Successful in 15s

基于 skill-template 脚手架开发,包含:
- 5 张业务表(教职工、请假政策、考勤日历、请假记录、假期余额)
- 请假核算引擎(扣薪计算、审批层级判定、年假抵扣)
- CLI 入口(import-employees / calculate-leave / render-html)
- HTML 审批与扣薪报告生成
- 示例数据与完整测试套件(295 tests passed)
This commit is contained in:
chenfuqiang
2026-09-07 16:59:24 +08:00
commit ee2a4d9e22
206 changed files with 29510 additions and 0 deletions

91
TUTORIAL.md Normal file
View File

@@ -0,0 +1,91 @@
## 本技能做什么
按学校政策为教职工请假申请自动核算扣薪金额、审批层级,并更新考勤与假期余额,输出审批单与扣薪报告。
## 你将完成什么
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 |
| 未知请假类型 | 在请假政策表中配置该假别后重试 |
| 需证件报错 | 提供相关证明文件后勾选「附证件」 |
| 报告无数据 | 先完成一次请假核算 |