v1.0.1: 奖助学金评定逻辑防伪校验 - 初版骨架

基于匠厂 skill-template 主仓 v1.0.108 派生的业务技能。

核心业务:
- 辅导员在汇总表中批量勾选候选人后自动触发
- 多源数据一致性校验(自报家庭年收入 vs 一卡通消费 vs 生源地 GDP)
- 横向排名可疑检测(综测 vs 成绩排名差值过大)
- 历史重复资助排查(本学年累计金额超限)

输出形态:
- 《奖助评定复核建议清单》HTML 报告
- 高风险个案推送至辅导员工作台
- 复核结果留痕(核查说明 + 终审结论)

预期提效:资助中心抽查工作量减少 80%;因认定不公引发的学生投诉事件下降 60%。

业务行生命周期:待审 → 已标注 → 已复核(保留 / 取消 / 调减)/ 已驳回 / 已撤回

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
2026-09-14 12:19:13 +08:00
commit 3f87f223f9
21 changed files with 1548 additions and 0 deletions

147
TUTORIAL.md Normal file
View File

@@ -0,0 +1,147 @@
# 使用教程
本技能有两种**平行**的使用方式:
- **数据管理**:在左侧「候选人汇总表」上点工具栏 / 行内按钮
- **对话任务**:用自然语言让 Agent 完成同一能力
定时任务是否提供:**见下方「入口三」**(当前为占位,按需启用)。
---
## 本技能做什么
```text
【候选人汇总表 + 一卡通消费 + 综测排名 + 历史资助】 → 【四类异常检测】 → 【复核建议清单】 → 【辅导员人工复核 → 终审】
```
- **输入**:辅导员批量勾选的候选人 + 一卡通消费数据 + 综测成绩排名 + 本学年已获资助记录 + 生源地人均 GDP
- **输出**:《奖助评定复核建议清单》HTML 报告 + 高风险个案推送
- **说明**:本技能不替代辅导员终审;所有异常仍需人工填写核查说明
---
## 开始前
确认:
1. 已安装并登录匠厂客户端
2. 已在技能市场安装本技能(建议更新到最新版)
3. 学生工作部 API / 一卡通中心 API / 教务系统 API 凭证已配置
4. 【如需】首次使用前先在「数据管理 → 一卡通消费」点击「立即同步」
5. 【如需】首次使用前先在「数据管理 → 生源地 GDP」点击「同步最新公开数据」
---
## 入口一:数据管理
适合:辅导员、学生处资助中心科员。
### 左侧各表是干什么的
| 表名(中文) | 作用 |
|--------------|------|
| 候选人汇总表 | 各班级辅导员批量勾选的国家助学金 / 励志奖学金 / 校级奖学金候选人 |
| 复核建议清单 | 防伪校验产出的高风险个案清单(含异常详情) |
| 困难认定 | 学生《家庭经济困难认定表》数据(只读) |
| 一卡通消费 | 学生食堂 / 超市月均消费额(只读) |
| 历史资助 | 本学年已获资助记录(用于累计金额比对) |
### 首次准备(若需要)
1. 进入 **数据管理** → **一卡通消费**
2. 点击表顶 **「立即同步」**(空表可点)
3. 成功后应看到:全校学生的一卡通月均消费额
### 主流程:批量校验某班级候选人
1. 进入 **候选人汇总表**
2. 勾选某班级所有候选人 → 点击 **「AI 校验」**
3. 等待 10~30 秒(按班级规模)
4. 完成后:
- 复核建议清单表新增若干行(含高风险个案)
- 异常候选人行状态变为「已标注」
- 辅导员工作台收到待复核通知
- 学生处资助中心科员收到复核个案汇总
### 行级 / 批量
| 你想做什么 | 操作 |
|------------|------|
| 校验一位候选人 | **候选人汇总表** 行内 → **「AI 校验」** |
| 批量校验某班级 | 勾选多行 → **「批量校验」** |
| 标记为待复核 | **候选人汇总表** 行内 → **「标记为待复核」** |
| 提交复核结果 | **复核建议清单** 行内 → **「提交复核结果」** |
| 查看复核清单 | **复核建议清单** 行内 → **「查看清单」** |
| 同步一卡通数据 | **一卡通消费** 表顶 → **「立即同步」** |
---
## 入口二:对话任务
适合:临时提问、不想切换表的用户。
### 什么时候用对话
- 临时想校验一位候选人,但不想打开数据管理
- 想用自然语言解释「为什么这位学生被标为异常」
- 想看「本月一共多少位高风险个案」
### 示例话术
| 你想做什么 | 可以这样说 |
|------------|------------|
| 校验一位候选人 | 「帮我校验张同学的助学金申请」 |
| 批量校验 | 「请把 XX 班所有候选人都校验一遍」 |
| 标记待复核 | 「把李同学标记为待复核」 |
| 提交复核 | 「张同学的核查说明已写好,提交复核」 |
| 查看本月统计 | 「本月一共多少位高风险个案?」 |
### Agent 可能追问什么
- 缺参数时:「请告诉我学生姓名 / 学号 / 班级」
- 一卡通数据缺失时:「该生一卡通消费数据未同步,请先到数据管理同步」
- 失败时:可改用数据管理点按钮重新触发
---
## 入口三:定时任务
### 本技能当前为占位(按需启用)
本技能**当前未启用定时任务入口**。如未来启用,建议场景:
- 每学期评定季开始前 7 天自动同步一卡通数据
- 评定季期间每日自动扫描已提交候选人的异常
启用条件:学生工作部系统提供定时回调 API,并经学生处资助中心确认自动化边界。
当前请使用 **数据管理** 或 **对话任务**。
---
## 主能力对照表
| 想做什么 | 数据管理 | 对话任务 |
|----------|----------|----------|
| 校验一位候选人 | **候选人汇总表** 行内 → **「AI 校验」** | 「帮我校验张同学的助学金申请」 |
| 批量校验 | 勾选多行 → **「批量校验」** | 「请把 XX 班所有候选人都校验一遍」 |
| 标记待复核 | 行内 → **「标记为待复核」** | 「把李同学标记为待复核」 |
| 提交复核结果 | **复核建议清单** 行内 → **「提交复核结果」** | 「张同学的核查说明已写好,提交复核」 |
| 查看复核清单 | **复核建议清单** 行内 → **「查看清单」** | 「把本月复核清单发给我」 |
按钮名必须与 `assets/actions.json` 的 `label` 一致。
---
## 常见卡住怎么办
| 现象 | 你可以先试 |
|------|------------|
| 「AI 校验」点不了 | 是否已配置三套 API;是否装错版本 |
| 校验很久没结果 | 看任务中心进度;候选人 > 500 可能耗时较久 |
| 异常过多 | 检查一卡通同步是否完整;本源 GDP 数据是否最新 |
| 复核提交失败 | 是否填写完整核查说明;是否在审核期内 |
| 学生一卡通数据缺失 | 学生可能近期未消费;可手动标记为「数据缺失」并跳过此项 |
仍无法解决时,把「你用的入口 + 操作步骤 + 界面提示原文」发给支持人员。