feat: 初始化高校人事请假考勤技能 (process-leave-attendance-default)
All checks were successful
技能自动化发布 / release (push) Successful in 15s
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:
91
TUTORIAL.md
Normal file
91
TUTORIAL.md
Normal 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 |
|
||||
| 未知请假类型 | 在请假政策表中配置该假别后重试 |
|
||||
| 需证件报错 | 提供相关证明文件后勾选「附证件」 |
|
||||
| 报告无数据 | 先完成一次请假核算 |
|
||||
Reference in New Issue
Block a user