高职学期授课计划自评

一、技能用途

对高职院校《学期授课计划》文件实施逐条量化评价。核心逻辑：以该课程《课程标准》为比对基准，加载规则集，对每一条检查点做二值判定（达标 / 不达标，条件豁免条目可判「默认达标」），累加各维度得分，最终输出可交付的 Excel 评价报告与重点整改清单。

规则集来源为学校现行《学期授课计划评价规则》（2026-10-09 经领导评审后重构）：

分值档：1 分 80 条 + 2 分 8 条 + 4 分 1 条，合计 100 分。4 分条目为序号 57（项目实训课每个项目的描述须含 a–h 八要素）。

16 个维度分组（评价维度为三级命名「一级-二级-三级」，同维度条目连续排列）：

二、触发条件

用户表达下列任一意图时启用本技能：学期授课计划评价 / 自评 / 评估、评价学期授课计划、自评学期授课计划、评估学期授课计划、授课计划评价，或提交学期授课计划文件要求打分 / 审核 / 检查。

三、输入材料

> 教学日历缺失不影响评价完整性：序号 23、27 已设条件豁免，缺该文件时直接判「默认达标」，勿因「缺少材料」而扣分。

四、执行流程

步骤 1 · 读取待评价的学期授课计划文件

读取全文并保留结构，重点抽取三块内容：

• 表1 基本信息（11 项）：院部名称、课程名称、任课教师、授课班级、理论学时、实践学时、理实一体、指导学习、项目学时、其他学时、总计学时。
• 表2 教学单元表（7 列）：周次、授课时间、标题、课程内容、课时数、课堂模式、授课地点。该表须逐行完整抽取为结构化记录（含每行的「课时数」数值）——序号 38–69 的判定全部依赖逐行读取，序号 41、45、52 的区间阈值还依赖当前行的课时数。
• 表3 审批意见：教研室负责人签字、院长（部门负责人）签字及日期栏。
• 另需记录：封面（学校名称、文件名称、学年学期）、脚注、文件名。

读取通道与全文获取（先判断，再取文）

.docx 优先走 tencent-docs-routing → tencent-local-office-edit（editor_sdk MCP）。但该 MCP 的结构类工具只回「预览」而非全文，段落 text_preview 会被截断（约 64 字符），逐条判定要求「依据定位」给出原文片段，截断文本不满足取证要求。

判定顺序：

1. 先用 doc_get_outline + doc_list_tables 摸清章节骨架与表格清单（轻量、够用）；
2. 若段落 / 单元格正文超过约 64 字符，直接改用 Python 解析 .docx 源文件取全文，并在回复中说明「因 MCP 段落读取截断，改用源文件解析」；
3. 表格若已由 MCP 完整取得，可与源文件解析结果交叉校验行数 / 列数 / 合并区域，确认一致后再判定。

Python 取全文的最小实现（标准库即可，无需 python-docx）：

import zipfile
from xml.etree import ElementTree as ET
W = '{http://schemas.openxmlformats.org/wordprocessingml/2006/main}'
z = zipfile.ZipFile(src)
body = ET.fromstring(z.read('word/document.xml')).find(W + 'body')
# 遍历 body 子节点：W+'p' 为段落，W+'tbl'/'W+tr'/'W+tc' 为表格
# 段落样式名取自 pPr/pStyle@val；样式显示名需另查 word/styles.xml 的 w:style[@w:styleId]/w:name@val

样式名必须核对 word/styles.xml：pStyle@val 是 styleId，不等于显示名。

不要依赖的通道：含大量中文路径的 find / head / tail / mkdir 等 coreutils 在某些 Bash 环境缺 /usr/bin 而不可用（须先 export PATH="/c/Program Files/Git/usr/bin:$PATH"），目录创建改用 Python os.makedirs。

步骤 2 · 读取对应课程的课程标准

读取课程标准全文，抽取以下要素供比对：

• 首页：课程名称、总学时，以及理论 / 实践 / 理实一体 / 指导学习 / 项目 / 其他各类学时数。
• 适用专业（序号 10 比对基准）。
• 课程目标：知识目标、能力目标、素质目标（含思政要求）清单 —— 序号 76、77、78 的比对基准。
• 教学单元设计表：单元 / 项目名称与顺序、各单元学时与课堂模式 —— 序号 48、72 的比对基准。
• 课程类别（A 类纯理论 / B 类理实一体 / C 类纯实践）—— 序号 19 的判定基准；课标未标注时按序号 19 的标准形态推定：
• 理论学时＋指导学习学时＋在线学习学时 ＝ 总计学时 → A 类；
• 理实一体学时 ＞ 0 且 项目学时 ＞ 0 且 项目学时 ＝ 单元表中项目案例学时之和 → B 类；
• 项目学时 ＝ 总计学时 → C 类。

> 课程标准缺失时，不得凭学期授课计划内部信息臆造比对基准；相关条目按「材料缺失」处理（见步骤 6）。

步骤 3 · 读取教学日历（可选）

若已提供，抽取每周的周次序号与日期区间（如「第 3 周 / 9月15日-9月19日」），用于序号 23、27 判定。

未提供时跳过本步骤，序号 23、27 判「默认达标」，并在报告「条件豁免与属性判定」工作表登记「教学日历未提供 → 豁免适用」。

步骤 4 · 加载评价规则文件

加载 references/rules-01-semester-plan.md，解析出 89 条规则的明细表（序号 / 评价维度 / 检查点 / 达标标准 / 分值）。

实现要点：明细表不要手敲 —— 用脚本解析规则稿中 ### / #### 小节标题与 4 列明细行，自动提取维度名与逐条标准（#### 标题即三级全键，如「教学单元表-课堂模式-项目案例课」；无 - 者为一级维度），既保证原文照录又零抄写误差。

同时加载规则稿的 §五 判定阈值表（含区间计算型、比例约束型可编码判据）与 §六 课堂模式速查表，二者是步骤 6 判定时的直接依据。

步骤 5 · 提取条件豁免条目

规则集中含 34 条条件性豁免条目，提取方式为：扫描「达标标准」文本中含「默认达标」字样的条目，自动归入豁免清单（不要硬编码序号，规则稿修订后序号会变）。

> 「实践课」「课堂翻转课」不设独立维度：二者仅受序号 31 约束（取值须属规定 10 种），不产生任何豁免条目，也不做课时数与内容构成检查。

豁免结论须写入报告「条件豁免与属性判定」工作表：逐条列出序号、检查点、豁免条件、本次是否适用、处理方式。

步骤 6 · 逐条判定

对 89 条检查点逐条独立判定，判定取值仅三种：

• 达标 — 计满该条分值（1 / 2 / 4 分）
• 默认达标 — 豁免条件成立，计满该条分值，注明豁免依据
• 不达标 — 计 0 分

判定证据要求：每条判定必须给出依据定位（学期授课计划 / 课程标准中的表格或章节名称 + 原文片段，一般不超过 60 字），不得仅给结论；原文中无对应内容时填「未检索到」。数值型与区间型条目另须在「判定依据数值」列给出实测值（见 §五 报告规范）。不达标项另须给出扣分原因与整改建议。

判定类型五分（不得混同）

一致性校验（须与课程标准逐项比对）

表内自洽校验（无需课程标准）

序号 18（分类学时之和＝总计学时，口径为理论、理实一体、指导学习、项目、其他 5 项，已剔除实践学时）、20（单元表课时合计＝表1 总计学时）。

课堂模式 × 课时数 × 内容构成（核心判据）

> 依据模版脚注，课堂模式共 10 种。「实践课」「课堂翻转课」不设独立维度，仅在序号 31 校验取值合规（2026-10-09 经用户确认）。

区间阈值须逐行计算：「当前行课时数」指该条记录所在行的「课时数」列取值 —— 例如某理论课行课时数为 4，则其知识模块数须落在 [4, 8] 区间。不得以全表统一阈值替代。

序号 57 的 a–h 八要素（4 分，须逐项核对并列出缺项）：
a 项目需求描述（≥ 200 字）／b 人（参与方式：单人 / 小组 / 跨专业小组）／c 机（软硬件标准及使用方式）／d 料（材料、物料）／e 法（起止日期、分工、流程或阶段划分、教师指导与检查点）／f 环（实践环境、安全、市场价值或社会价值）／g 标（交付标准与要求）／h 政（思政点融入）。

周次与课时量：同一周次可存在多条记录；「周次」列可区间表述（如 3-5，序号 22）；各周课时量须分布均衡（序号 70）。

材料缺失处理

仅当课程标准未提供时，下列 15 条无法判定，判为「不达标」并计 0 分，扣分原因注明「材料缺失」：9、10、11–17、19、72、76–79。

下列条目不属材料缺失，始终可在表内独立判定：18、20、21–37、38–69、70、71、73–75、80–89。

> 「材料缺失」须在报告中单独统计条目数，与实质性不达标区分呈现，便于用户区分「文件本身有缺陷」与「评价材料不齐」。

步骤 7 · 计算维度得分与总分，生成 Excel 评价报告

• 按三级维度累加「条目数 / 分值小计 / 得分 / 得分率」，并给出各一级维度小计。
• 累加总分，与满分 100 比对，计算得分率。
• 统计四项条目数：达标（含默认达标）、不达标、材料缺失、条件豁免生效。

Excel 文件生成本身不是本技能的职责范围，须先加载 tencent-docs-routing 技能，再由其路由至 tencent-docs-sheet-generation 技能创建 xlsx（本场景无源表格文件，属从零生成）。

报告结构见 §五 输出格式。

生成报告后，必须通过文件呈现工具将 xlsx 交付给用户，并在回复中给出：总分与得分率、维度得分薄弱项、重点整改条目数及主要问题概述、材料缺失情况与判定假设（如有）。

五、输出格式（Excel 评价报告规范）

报告包含 4 个工作表，文件命名建议：学期授课计划评价报告-<课程名称>-<YYYYMMDD>.xlsx，保存至当前工作目录或用户指定位置。

Sheet 1「评价总览」

• 基本信息区：课程名称 / 院部名称 / 任课教师 / 授课班级 / 学年学期 / 总学时 / 课程类别 / 评价日期 / 所用规则文件与版本（须注明规则稿 v2.0）/ 规则条目数 / 满分 / 评价人。
• 结果区：总分 / 满分 / 得分率 / 达标条目数 / 不达标条目数 / 材料缺失条目数 / 默认达标条目数。
• 维度得分矩阵（三级展开）：

• 末尾追加一级维度小计行（「教学单元表」「基本信息」等），其条目数与得分用通配符公式汇总。
• 若存在课程类别推定、材料缺失等假设，在末行注明「判定假设」；并注明「规则稿 v2.0 与源表在序号 55、58 存在 2 处豁免条件修正差异」（见规则稿 §八）。

Sheet 2「逐条判定明细」（覆盖 89 条全部条目，按序号升序）

• 「判定结果」取值：达标 / 默认达标 / 不达标。
• 「达标标准」原文照录，保证报告可独立复核。
• 「判定依据数值」列（本次新增，A–L 列中的 H 列）：呈现实测数值，使扣分可复核。填写口径：

• 「依据定位」为该条在学期授课计划或课程标准中的来源 + 原文片段；「扣分原因」仅不达标 / 材料缺失项填写。
• 本表末尾须追加「汇总维度」列（L 列），逐行写入与 Sheet 1 维度矩阵完全一致的三级全键（如「教学单元表-课堂模式-项目案例课」「学时一致性」）。Sheet 1 的条目数 / 分值小计 / 得分一律用 COUNTIF / SUMIF 引用本列，不得手填或硬编码。

实现要点（避免返工）：

• 「达标标准」用脚本解析 references/rules-01-semester-plan.md 自动提取，不手敲。
• 「得分」写成公式 =IF($F2="不达标",0,$E2)，不写死（分值档含 4 分，公式通用）；「判定结果」列加条件格式（不达标 → 红底红字 #FFC7CE / #9C0006；默认达标 → 绿底绿字 #C6EFCE / #006100）。
• Sheet 1 结果区全部公式化：总分 =SUM(逐条判定明细!G2:G90)；达标条目数 =COUNTIF(逐条判定明细!F2:F90,"达标")+COUNTIF(逐条判定明细!F2:F90,"默认达标")；材料缺失条目数 =COUNTIF(逐条判定明细!J2:J90,"材料缺失*")（依赖「扣分原因」列以「材料缺失」开头）；得分率须带分母空值 + 0 值保护。
• 维度矩阵：叶行用精确匹配 =COUNTIF(逐条判定明细!$L$2:$L$90,$<维度键单元格>)；一级小计行用通配符 =COUNTIF(逐条判定明细!$L$2:$L$90,"教学单元表-*")。
• 明细末行随条目数变动，不得硬编码：本规则集 89 条 → 数据行 2:90。规则稿修订后须同步重算行号。
• 公式必须经 recalc 产出缓存值后方可交付；本机未装 LibreOffice，可由纯 Python 引擎降级补齐（依赖装在隔离 venv C:\Users\Sean\.workbuddy\binaries\python\envs\default）。
• 生成后的 xlsx 交付前须扫描公式错误（#REF! / #VALUE! 等），有错不得交付。

Sheet 3「重点整改清单」（仅含不达标与材料缺失条目）

• 排序规则：按分值降序；分值相同按序号升序。（4 分条目序号 57 须排在最前）
• 表尾给出合计扣分。

Sheet 4「条件豁免与属性判定」

• 属性判定区：属性项 / 判定值 / 来源依据。至少覆盖：课程类别（A/B/C）、教学日历是否提供、学期授课计划中实际出现的课堂模式集合。
• 豁免条目区：

六、硬性约束

1. 规则集唯一，不得增删检查点，不得改写达标标准语义；89 条全部条目均须出现在「逐条判定明细」中。
2. 每条判定必须有依据定位，禁止无证据判定；数值型与区间型条目须同时给出「判定依据数值」。
3. 不得臆造阈值。所有数值判据以规则稿「§五 可直接编码的判定阈值」为准。
4. 区间型阈值须逐行计算：序号 41、45、52 的容许区间随当前行课时数浮动，不得以全表统一阈值替代，也不得只用首行或典型行代替。
5. 不得自行设定合格线。「得分率」仅为参考指标；是否合格由学校规定或用户指定，技能不得擅自作合格 / 不合格结论。
6. 条件豁免判定顺序：先提豁免清单 → 再判定适用性 → 最后决定该条「实评」还是「默认达标」，避免误扣分。
7. 不得把全表统计型条目当作逐行判定型（序号 39、68），反之亦然；单元表逐行判定不得退化为全表统计。
8. 不得为「实践课」「课堂翻转课」套用其他模式的规则：二者仅受序号 31 约束（取值合规），不做课时数与内容构成检查。
9. 序号 57 须逐项核对 a–h：不得因「整体描述较完整」即判达标，须列出实际具备的要素与缺项。

七、参考文件索引

规则稿体量约 30 KB，按需加载：默认载入 §二 判定模型、§三 维度分布、§四 明细、§五 阈值表、§六 速查表即可。

八、维护说明

规则稿同步（每次源表修订后必做）

以 xlsx 为唯一事实来源：C:\Users\Sean\Desktop\学期授课计划评价规则.xlsx（工作表 学期授课计划评价规则，有效区域 A1:E91，合计行 =SUM(E2:E90) → 100）。

规则稿由生成脚本从 xlsx 读回自动生成，不得手工编辑 md。生成脚本（to_md.py）须满足：

1. 完全数据驱动：自动定位合计行、自动推导条目数 / 序号区间 / 维度分组 / 分值分布 / 豁免清单，不硬编码任何序号。
2. 三级维度按 - 分段（最多 3 段），§四 按一级维度归并 ###、按三级全键输出 ####。
3. 单元格换行须转为 <br>：源表存在含换行的达标标准（如序号 57），直接输出会破坏 md 表格。
4. 序号压缩用连续区间算法：非连续序号（如 23、27）须逐项罗列或按真实连续段压缩，不得简单写成首尾区间（会误圈中间不豁免的条目）。
5. 豁免条件名称按维度语义校验：源表曾出现豁免句误写课堂模式名的笔误（序号 55、58 已修正），脚本须按维度归属自动校正并登记到「待源表确认事项」。
6. 交付前自检：序号 1–N 连续无断号、分值合计 = 100、§三 维度分布与 §四 明细交叉核对一致、§五 / §六 引用的序号均存在、md 表格行无破损（无 **** 叠粗、无跨行截断）。

报告与规则稿的一致性

报告基于修订过的规则稿时，须在报告基本信息区注明所用规则稿版本及「与源表存在差异」字样。