# 使用教程

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

- **数据管理**：在左侧「合同台账」表上点工具栏 / 行内按钮
- **对话任务**：用自然语言让 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 天阈值是否到达 |
| 考核数据缺失 | 在党委教师工作部系统补录考核数据后，重新触发扫描 |

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