Files
process-leave-attendance-de…/TUTORIAL.md
chenfuqiang ee2a4d9e22
All checks were successful
技能自动化发布 / release (push) Successful in 15s
feat: 初始化高校人事请假考勤技能 (process-leave-attendance-default)
基于 skill-template 脚手架开发,包含:
- 5 张业务表(教职工、请假政策、考勤日历、请假记录、假期余额)
- 请假核算引擎(扣薪计算、审批层级判定、年假抵扣)
- CLI 入口(import-employees / calculate-leave / render-html)
- HTML 审批与扣薪报告生成
- 示例数据与完整测试套件(295 tests passed)
2026-09-07 16:59:24 +08:00

2.4 KiB
Raw Blame History

本技能做什么

按学校政策为教职工请假申请自动核算扣薪金额、审批层级,并更新考勤与假期余额,输出审批单与扣薪报告。

你将完成什么

  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
未知请假类型 在请假政策表中配置该假别后重试
需证件报错 提供相关证明文件后勾选「附证件」
报告无数据 先完成一次请假核算