taojianmin
1d78e542ca
基于匠厂 skill-template 主仓 v1.0.108 派生的业务技能。 核心业务： - 教师在教务系统提交新开课或修订大纲时自动触发 - 格式结构 + 课程目标与毕业要求矩阵匹配 + 课程思政融合度三维体检 - 以批注模式嵌入原 Word 文档，文末给出百分制评分 输出形态： - Word 文档红 / 黄 / 绿三色批注 - 百分制体检评分 + HTML 体检报告 + 修改建议清单 预期提效：教务处培养方案审核环节的返工次数减少 70%；大纲编制的规范性达到 95% 以上。 业务行生命周期：无（一次性体检结果存档，不重复处理） Co-Authored-By: Claude Code <noreply@anthropic.com>
147 lines
5.9 KiB
Markdown
147 lines
5.9 KiB
Markdown
# 使用教程
|
||
|
||
本技能有两种**平行**的使用方式：
|
||
|
||
- **数据管理**：在左侧「课程大纲」表上点工具栏 / 行内按钮
|
||
- **对话任务**：用自然语言让 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 | 关键词库为空或关键词文件未同步；先到「课程思政关键词」表配置 |
|
||
|
||
仍无法解决时，把「你用的入口 + 操作步骤 + 界面提示原文」发给支持人员。
|