Files
alert-contract-expiring-hr/TUTORIAL.md
taojianmin e2b45d690e v1.0.1: 合同到期智能预警与续聘辅助 - 初版骨架
基于匠厂 skill-template 主仓 v1.0.108 派生的业务技能。

核心业务:
- 每日凌晨定时扫描全校教职工合同电子台账
- 距到期日 90 / 60 / 30 天分级预警(黄 / 橙 / 红)
- 自动生成个人版《续聘准备任务书》与单位版《本月到期人员清单》
- 30 天红色预警自动抄送分管校领导

输出形态:
- 个人版 HTML 任务书 + 单位版 PDF 清单 + 三级预警通知

预期提效:因合同逾期未续签导致的劳动纠纷降为 0;人事处年终集中突击签合同的工作量减少 60%。

业务行生命周期:可续聘 → 预警中(黄 / 橙 / 红)→ 已续签 / 已驳回 / 已过期

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-14 12:19:11 +08:00

5.8 KiB
Raw Blame History

使用教程

本技能有三种平行的使用方式:

  • 数据管理:在左侧「合同台账」表上点工具栏 / 行内按钮
  • 对话任务:用自然语言让 Agent 完成同一能力
  • 定时任务:每日凌晨 02:00 自动扫描全校合同到期情况

三种方式触发同一套业务能力,结果一致,选你习惯的即可。


本技能做什么

【合同电子台账 + 考核数据 + 师德数据】 → 【距到期日 90/60/30 天分级】 → 【个人任务书 + 单位清单】 → 【红头预警自动抄送】
  • 输入:全校教职工合同电子台账 + 近 3 年考核结果 + 师德师风考评记录
  • 输出:个人版《续聘准备任务书》+ 单位版《本月合同到期人员清单》+ 三级预警通知
  • 说明:本技能不替代人事处终审;AI 建议仅供二级单位参考,最终决定权在人事处与分管校领导

开始前

确认:

  1. 已安装并登录匠厂客户端
  2. 已在技能市场安装本技能(建议更新到最新版)
  3. 人事系统 API 与党委教师工作部 API 凭证已配置(HR_API_TOKEN / TEACHER_AFFAIRS_API_TOKEN 已登记到本技能 .env)
  4. 二级单位人事秘书通讯录已登记
  5. 【如需】首次使用前,先在「数据管理 → 合同台账」点击一次「立即同步」载入最新合同数据

入口一:数据管理

适合:人事处合同管理员、二级单位人事秘书、喜欢点界面操作的用户。

左侧各表是干什么的

表名(中文) 作用
合同台账 全校教职工合同电子台账主表,状态行可见
预警记录 每次扫描产生的预警条目(含黄/橙/红等级)
续聘任务 已生成的续聘任务书记录(个人 / 单位版)
派发日志 每一条预警的派发状态、接收人、是否已读

首次准备(若需要)

  1. 进入 数据管理 → 合同台账
  2. 点击表顶 「立即同步」(空表可点)
  3. 成功后应看到:全校教职工合同基本信息、合同类型、起止日期、聘任岗位

主流程:触发一次合同到期扫描

  1. 进入 合同台账
  2. 点击表顶 「立即扫描到期合同」
  3. 等待 30 秒~2 分钟(按全校合同规模)
  4. 完成后:
    • 预警记录表新增若干行(含黄/橙/红等级)
    • 距到期日 30 天内的合同行进入「预警中(红色)」状态
    • 教师本人收到个人版《续聘准备任务书》通知
    • 二级单位人事秘书收到单位版《本月到期清单》通知
    • 30 天红色预警自动抄送分管校领导

行级 / 批量

你想做什么 操作
给某位教师生成续聘任务书 合同台账 行内 → 「生成续聘任务书」
下发单位版清单 选中某单位的多行 → 「按单位生成清单」
标记已续签 合同台账 行内 → 「标记为已续签」(须上传续签材料)
重新触发预警 合同台账 行内 → 「重新触发预警」

入口二:对话任务

适合:临时提问、不想切换表的用户。

什么时候用对话

  • 临时想知道某位教师的合同什么时候到期
  • 想用自然语言解释「为什么 AI 建议不续聘」
  • 想看「本月一共要办多少份续聘」

示例话术

你想做什么 可以这样说
查询某教师合同 「张老师的合同什么时候到期?」
触发扫描 「帮我扫描一下全校合同到期情况」
生成任务书 「给李老师生成一份续聘准备任务书」
查看本月统计 「本月一共要办多少份续聘?」
解释建议 「为什么 AI 建议王老师续聘观察?」

Agent 可能追问什么

  • 缺参数时:「请告诉我教师姓名 / 工号 / 合同 ID」
  • 数据缺失时:「该教师近 3 年考核数据缺失,请先在党委教师工作部系统补录」
  • 失败时:可改用数据管理点按钮重新触发

入口三:定时任务

本技能已启用定时扫描

  1. 打开侧栏 定时任务 → 新建
  2. 选择本技能 → Action 「扫描即将到期合同」
  3. 默认参数:
    • 扫描阈值:90 / 60 / 30 天
    • 扫描时间:每日凌晨 02:00(可在定时任务面板调整)
    • 抄送规则:30 天红色预警自动抄送分管校领导
  4. 填写保存;可「立即运行」验证
  5. 每日到点后在「预警记录」表查看本次扫描结果

主能力对照表

想做什么 数据管理 对话任务 定时任务
扫描全校合同到期 表顶 「立即扫描到期合同」 「帮我扫描一下全校合同到期」 ✅ 每日凌晨 02:00 自动
生成个人任务书 行内 → 「生成续聘任务书」 「给李老师生成一份续聘任务书」 —
下发单位清单 批量 → 「按单位生成清单」 「给 XX 学院下发本月清单」 —
标记已续签 行内 → 「标记为已续签」 「张老师合同已续签」 —

按钮名必须与 assets/actions.json 的 label 一致。


常见卡住怎么办

现象 你可以先试
「立即扫描到期合同」点不了 是否已配置人事系统 API;是否装错版本
扫描很久没结果 看任务中心进度;合同规模 > 2000 份可能耗时较久
教师没收到任务书 检查教师通讯录中是否登记了正确的手机 / 邮箱
红色预警没抄送领导 检查分管校领导通讯录是否配置;30 天阈值是否到达
考核数据缺失 在党委教师工作部系统补录考核数据后,重新触发扫描

仍无法解决时,把「你用的入口 + 操作步骤 + 界面提示原文」发给支持人员。