v1.0.1: 合同到期智能预警与续聘辅助 - 初版骨架
基于匠厂 skill-template 主仓 v1.0.108 派生的业务技能。 核心业务： - 每日凌晨定时扫描全校教职工合同电子台账 - 距到期日 90 / 60 / 30 天分级预警（黄 / 橙 / 红） - 自动生成个人版《续聘准备任务书》与单位版《本月到期人员清单》 - 30 天红色预警自动抄送分管校领导 输出形态： - 个人版 HTML 任务书 + 单位版 PDF 清单 + 三级预警通知 预期提效：因合同逾期未续签导致的劳动纠纷降为 0；人事处年终集中突击签合同的工作量减少 60%。 业务行生命周期：可续聘 → 预警中（黄 / 橙 / 红）→ 已续签 / 已驳回 / 已过期 Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
145
TUTORIAL.md
Normal file
145
TUTORIAL.md
Normal file
@@ -0,0 +1,145 @@
|
||||
# 使用教程
|
||||
|
||||
本技能有三种**平行**的使用方式：
|
||||
|
||||
- **数据管理**：在左侧「合同台账」表上点工具栏 / 行内按钮
|
||||
- **对话任务**：用自然语言让 Agent 完成同一能力
|
||||
- **定时任务**：每日凌晨 02:00 自动扫描全校合同到期情况
|
||||
|
||||
三种方式触发同一套业务能力，结果一致，选你习惯的即可。
|
||||
|
||||
---
|
||||
|
||||
## 本技能做什么
|
||||
|
||||
```text
|
||||
【合同电子台账 + 考核数据 + 师德数据】 → 【距到期日 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 天阈值是否到达 |
|
||||
| 考核数据缺失 | 在党委教师工作部系统补录考核数据后，重新触发扫描 |
|
||||
|
||||
仍无法解决时，把「你用的入口 + 操作步骤 + 界面提示原文」发给支持人员。
|
||||
Reference in New Issue
Block a user