# 使用教程

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

- **数据管理**：在左侧「课程大纲」表上点工具栏 / 行内按钮
- **对话任务**：用自然语言让 Agent 完成同一能力

定时任务是否提供：**见下方「入口三」**（当前为占位，按需启用）。

---

## 本技能做什么

```text
【教师 Word 大纲 + 专业培养方案 + 编制规范】 → 【格式结构 + 矩阵匹配 + 思政融合度】 → 【Word 批注 + 体检报告】 → 【百分制评分 + 修改建议】
```

- **输入**：教师撰写的《课程教学大纲》Word + 对应专业最新版《人才培养方案》PDF + 学校《课程大纲编制规范》红头文件
- **输出**：原 Word 文档的批注 + 百分制体检评分 + 修改建议清单 + HTML 体检报告
- **说明**：本技能不替代教务处终审；评分 ≥ 85 分建议直接送审，60~85 分建议修改后送审，< 60 分必须修改

---

## 开始前

确认：

1. 已安装并登录匠厂客户端
2. 已在技能市场安装本技能（建议更新到最新版）
3. 教务系统 API 凭证已配置（`AA_API_TOKEN` 已登记到本技能 `.env`）
4. 教师撰写的《课程教学大纲》Word 文档已上传到教务系统
5. 对应专业最新版《人才培养方案》PDF 已入库（一次性导入，后续自动匹配）
6. 学校《课程大纲编制规范》红头文件已入库

---

## 入口一：数据管理

适合：课程负责人、教研室主任、二级学院教学秘书。

### 左侧各表是干什么的

| 表名（中文） | 作用 |
|--------------|------|
| 课程大纲 | 全部课程大纲主表（含体检状态） |
| 体检记录 | 每次体检的结果（含评分、不达标项） |
| 培养方案 | 各专业最新版《人才培养方案》PDF 索引 |
| 编制规范 | 《课程大纲编制规范》红头文件索引 |
| 课程思政关键词 | 当前启用的思政关键词列表与权重 |

### 首次准备（若需要）

1. 进入 **数据管理** → **培养方案**
2. 点击表顶 **「导入培养方案」**（空表可点）
3. 成功后应看到：本校全部专业的培养方案 PDF 文件、对应年级、毕业要求指标点摘要

### 主流程：对一份大纲做合规体检

1. 进入 **课程大纲**
2. 选中待体检的行 → 点击 **「体检这份大纲」**
3. 等待 30 秒~1 分钟（向量化 + Word 回写）
4. 完成后：
   - 原 Word 文档出现红 / 黄 / 绿三色批注
   - 体检记录表新增一行（含评分 + 不达标项）
   - 大纲表状态自动更新为「已通过 / 待修改 / 驳回」

### 行级 / 批量

| 你想做什么 | 操作 |
|------------|------|
| 体检单份大纲 | **课程大纲** 行内 → **「体检这份大纲」** |
| 批量体检某专业所有大纲 | 选中多行 → **「批量体检」** |
| 查看体检报告 | **体检记录** 行内 → **「查看报告」** |
| 重新体检 | **课程大纲** 行内 → **「重新体检」** |
| 同步编制规范 | **编制规范** 表顶 → **「立即同步」** |

---

## 入口二：对话任务

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

### 什么时候用对话

- 临时想给某份大纲做体检，但不想打开数据管理
- 想用自然语言解释「为什么这份大纲 82 分」
- 想看「本月一共体检了多少份大纲 / 平均分是多少」

### 示例话术

| 你想做什么 | 可以这样说 |
|------------|------------|
| 体检一份大纲 | 「帮我给《数据结构》大纲做一下体检」 |
| 批量体检 | 「请把计算机专业所有大纲都体检一遍」 |
| 查看评分 | 「《高等数学》大纲现在多少分？」 |
| 解释评分 | 「为什么《XX》大纲 82 分？」 |
| 同步规范 | 「同步一下课程大纲编制规范」 |

### Agent 可能追问什么

- 缺参数时：「请告诉我课程名称 / 大纲 ID / 教师姓名」
- 培养方案缺失时：「该课程对应专业的培养方案尚未导入，请先到数据管理导入」
- 失败时：可改用数据管理点按钮重新触发

---

## 入口三：定时任务

### 本技能当前为占位（按需启用）

本技能**当前未启用定时任务入口**。如未来启用，建议场景：

- 开学前 1 个月（每年 8 月）自动对全校新开课大纲做集中体检
- 编制规范文件更新后自动重检存量大纲

启用条件：教务系统提供体检排期 API，并经教务处教学科确认自动化边界。

当前请使用 **数据管理** 或 **对话任务**。

---

## 主能力对照表

| 想做什么 | 数据管理 | 对话任务 |
|----------|----------|----------|
| 体检一份大纲 | **课程大纲** 行内 → **「体检这份大纲」** | 「帮我给《数据结构》大纲做体检」 |
| 批量体检 | 勾选多行 → **「批量体检」** | 「请把计算机专业所有大纲都体检一遍」 |
| 查看体检报告 | **体检记录** 行内 → **「查看报告」** | 「《XX》大纲现在多少分？」 |
| 重新体检 | **课程大纲** 行内 → **「重新体检」** | 「再体检一次《XX》大纲」 |
| 同步编制规范 | **编制规范** 表顶 → **「立即同步」** | 「同步一下课程大纲编制规范」 |

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

---

## 常见卡住怎么办

| 现象 | 你可以先试 |
|------|------------|
| 「体检这份大纲」点不了 | 是否已配置教务系统 API；是否装错版本 |
| 体检很久没结果 | 看任务中心进度；大纲过大（>3MB）可能耗时较久 |
| 评分明显偏低 | 检查培养方案是否已正确导入；课程目标是否含完整段落（仅一行字会判为不达标） |
| Word 批注没出现 | 检查教务系统是否支持批注回写；如不支持，仅生成 HTML 报告 |
| 课程思政关键词全为 0 | 关键词库为空或关键词文件未同步；先到「课程思政关键词」表配置 |

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