check-course-syllabus-aa/TUTORIAL.md

使用教程

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

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

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

---

本技能做什么

【教师 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	关键词库为空或关键词文件未同步；先到「课程思政关键词」表配置

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