Ruijin消化病例分析批改

技能版本：v3.1.4（v3.1.0 新增批改同时同步输出官方《病例分析质量评估表》打分表；v3.0.0 起批注写入统一走融合引擎 scripts/comment_engine.py——全文档遍历 + 对象模型写回 + 精确锚点三合一，弃用旧 zipfile 手拼 XML 路线；基于25份已批改消化病例分析真实批注 + 24份消化科临床指南(2020-2026)；病例分析模板无「带教老师评语」栏，write_summary=False。批改规则、评分标准未变。上一版 v2.3.0 同步 2026 最新消化指南）

概述

本skill用于批改消化科方向临床药师规范化培训学员的病例分析作业。基于2026最新版《病例分析质量评估表》四维度ABCD等级评分标准(总分100分制)和25份消化科真实批改样本，聚焦消化科常见疾病谱和批改关注点，系统化地对学员作业进行评估，以Word原生批注气泡形式直接在docx文件中插入批改意见（评价性内容并入对应批注，不单独成段）。

核心能力：
- 基于25份真实批注的频率驱动批改(极高频/高频/中高频关注点分层)
- 基于24份临床指南(2020-2026)的6大病种专业评估框架
- D1-D4四级循证讨论深度自动评级
- 批注用语模板库(格式/结构/内容/分析/ADR/结论6类)
- docx原生批注气泡输出（非Markdown报告，直接在原文件中批注）

评分规则（2026最新版《病例分析质量评估表》）

四维度ABCD等级评分，总分100分：

评分等级：

四维度与原有4维度12评分点对应关系：

> 批改时先逐维度检查确定ABCD等级，再汇总得分定级。下方评分标准权重表中的12个评分点作为各维度定级参考。

批改工作流程

第1步：接收作业并识别病种

用户提供病例分析作业(docx文件)。使用python-docx提取全文文本和表格内容：

import importlib.util
spec = importlib.util.spec_from_file_location('ce', r'<技能目录>\scripts\comment_engine.py')
CE = importlib.util.module_from_spec(spec); spec.loader.exec_module(CE)
from docx import Document
doc = Document('作业文件.docx')
for para, text in CE.iter_doc_paragraphs(doc):  # 正文 + 所有表格（含嵌套表格）
    if text.strip():
        print(text)

> ⚠️ 文本抽取陷阱（必读，防误批学员）：p.text/cell.text（即 python-docx 的 paragraph.text）只取 <w:t> 文本，会静默丢弃 run 级字符元素，导致读错原文并误批：
>
> | 元素 | 显示为 | 丢弃后果（真实案例） |
> |---|---|---|
> | <w:noBreakHyphen/> | - | 每2-3日→每23日、LDL-C→LDLC、D-二聚体→D二聚体、文献页码 241-256→241256 |
> | <w:sym w:char="XXXX"/> | 对应符号 | 字符消失 |
> | <w:tab/>/<w:ptab/> | 空白 | 文本粘连 |
> | <w:br/>/<w:cr/> | 换行 | 两行并作一行 |
>
> 正确做法：统一用融合引擎 CE.para_text(paragraph)（run 级完整还原 t/noBreakHyphen/sym/tab/br 等），而不是 p.text。判定纪律：抽取文本出现「每 N 天/月/周」N 为多位数、纯数字日期、术语缺连字符（LDLC/DPP4/β内酰胺类）、文献页码连写时，先怀疑丢字，回查原文确认后再下结论；学员用 2-3日/3-5天 表示范围是规范写法，不得批注。

提取后自动识别： 病种分类(肝硬化/胰腺炎/IBD/Hp-GERD/胆道肝脓肿/DILI乙肝)、药学事件类型。

> 检查点1 [CHECKPOINT]：展示病种识别结果和药学事件概要，请用户确认是否正确。如识别有误，由用户指定正确的病种分类。

第2步：必查项扫描

按25份真实批改频率统计，优先执行5项必查扫描：

第3步：按评分标准逐项评估

按四大维度12个评分点逐项评定，每项写出得分和扣分说明。评定结果汇总至四维度ABCD评分框架（见"评分规则"章节）。

评分标准权重表(10分制→四维度ABCD定级参考)：

第4步：必查项—病例选择评估(权重4.5分，最核心项)

判断病例是否具有明确的药学事件：

合格病例特征： 选择有药学事件的案例(ADR/药物相互作用/方案调整等)，非疾病综述。

不合格病例特征识别：

第5步：病种专业评估

根据第1步识别的病种，从下表选取对应的专业评估要点融入评分。

> 详细药物方案和剂量见 references/指南学习_*.md

肝硬化相关病例

急性胰腺炎相关病例

IBD相关病例

Hp/GERD/PPI相关病例

胆道感染/肝脓肿相关病例

DILI/乙肝相关病例

第6步：循证讨论深度评级(D1-D4)

判断学员讨论的循证深度等级：

常见循证缺陷批改用语：

> 检查点2 [CHECKPOINT]：展示评分初稿（评分总览表+各维度得分），请用户审核并确认是否调整。

第7步：评分汇总（🛑 不生成评语）

汇总Step 2-6所有评估结果，生成评分总览，展示给用户确认。

🛑 病例分析模板没有独立的「带教老师评语」位置（实测样文 0 份含该栏），因此不生成带教评语、不写入评语表格、不在文档末尾追加评语段落；评价性内容一律并入对应位置的批注，不单独成段。

评分总览表（四维度ABCD等级）：

等级评定： 优秀(≥85) / 合格(70-84) / 不合格(<70)

评价性内容落点（并入批注，不单独成段）：

常用句式："可进一步了解……"、"建议关注……"、"可对比学习……"

术语与格式专项检查（纳入批注清单）：

• 首次出现英文术语须标注"中文全称(英文全称，英文缩写)"，下同。同一名词仅批注1次。
• 文中不单独使用商品名；通用名与商品名同时出现时不批注；商品名单独出现时需批注。

消化科常用术语规范示例：

> 检查点3 [CHECKPOINT]：展示评分总览表、各评分项详细评估（含得分和扣分原因）、批注清单（批注位置+批注内容+对应评分项）。请用户最终确认。用户可要求修改任何评分或批注内容。

第8步：批注插入与文件输出

用户确认评分后，执行：

1. 将每条批注以Word原生批注气泡形式插入病例分析docx文件
2. 输出文件：原文件名-批改.docx（不覆盖原文件）

> 🛑 不写入评语：不在文档末尾追加评语段落，评价性内容全部已并入批注。

批注形式： Word原生"审阅→插入批注"气泡，禁止将批注文字插入正文

批注作者： w:author="消化带教老师"，w:initials="消化带教老师"

批注语言： 中文

技术实现详见"批注实现技术细节"章节。

同步输出质量评估表（打分表）

批改完成、输出批改 Word 后，同步生成对应的官方《病例分析质量评估表》打分表（附件1-4，xlsx）。

• 模板：内嵌于 scripts/template_data.py（官方评估表原文件 base64，与官方 .xlsx 逐字节一致）——因上传平台（SkillHub 等）的文件类型白名单不含 .xlsx，技能包内不再携带 .xlsx；调用时 template_path=None 即自动使用内嵌模板（若显式传入一个存在的 .xlsx 路径，则优先用该文件）
• 做法：以模板为底，复制后仅写入四个评分维度的「得分」列（G4:G7）；总分列 G8 保留模板求和公式，由 Excel/WPS 打开时自动计算；标题、评估要点原文、分值区间、边框、列宽、行高、合并单元格等格式 100% 保留，不新增、不删除模板任何文字
• 四个维度及满分（即评分总览表各维度得分）：
  | 维度 | 满分 |
  |------|------|
  | 基本要求 | 30 |
  | 病例概述 | 30 |
  | 分析总结 | 30 |
  | 参考文献 | 10 |
• 调用（与批注写入同一脚本流程内执行）：

python from scoring_sheet import write_score_sheet write_score_sheet( template_path=None, # 自动使用 scripts/template_data.py 内嵌的官方模板（包内无需 .xlsx） output_path=r'<输出目录>\{原文件名}-打分表.xlsx', scores={'基本要求': N1, '病例概述': N2, '分析总结': N3, '参考文献': N4}, )

• 输出文件：与批改 docx 同名同目录，后缀 -打分表.xlsx；在最终确认步骤中一并展示打分表路径、各维度得分与总分

第9步：最终确认

输出文件后展示：
- 输出文件路径
- 批注总数
- 各维度得分汇总

等待用户确认是否需要调整。

边界条件与异常处理

docx文件异常

docx读取异常

内容异常

输出处理

评分异常

消化科常用批改用语速查

批改精简原则

• 同一术语/商品名仅批注1次，附"下同"
• 连续引用指南超过10行视为大段引用
• 引用后已结合患者分析者可不批注"需结合本患者"
• 避免重复批注同类问题，重点突出关键问题

批注实现技术细节

核心要求

1. 批注形式：Word原生"审阅→插入批注"气泡，禁止将批注文字插入正文
2. 批注作者：w:author="消化带教老师"，w:initials="消化带教老师"
3. 批注语言：中文
4. 输出文件：原文件名后加 -批改 后缀，不覆盖原文件

实现方式（融合引擎 comment_engine.py）

v3.0.0 起弃用旧 zipfile 手拼 XML 路线（解包 → document.xml 正则切分 → 手拼 comments.xml / commentsExtended.xml → 手改 rels / Content_Types → 重新打包），统一走融合引擎 scripts/comment_engine.py——全文档遍历 + 对象模型写回 + 精确锚点三合一：

import importlib.util
spec = importlib.util.spec_from_file_location('ce', r'<技能目录>\scripts\comment_engine.py')
CE = importlib.util.module_from_spec(spec); spec.loader.exec_module(CE)

report = CE.grade(
    source_path, output_path,
    comments_data,              # [(anchor, comment_text)] 或 [(anchor, comment_text, mode)]
    author='消化带教老师', initials='消化带教老师',
    write_summary=False,        # 病例分析模板无评语栏，不写评语
)
# report: {"total","inserted","missed","ambiguous","degraded","summary_written"}

融合引擎三要点：

1. 全文档遍历：iter_doc_paragraphs() 遍历正文段落 + 所有表格（递归嵌套表格），不再手工按 <w:p> 分割
2. 对象模型写回：python-docx 官方 Comments.add_comment() + OPC 自动维护部件关系（comments.xml / commentsExtended.xml / people.xml 自动创建、rels 自动 relate），弃用手拼 PackURI / _blob
3. 精确锚点：find_anchor() 支持 contains/exact/startswith + 全文档命中计数，missed/ambiguous/degraded 显式上报，不再静默丢失批注

> Fallback：锚定文本找不到时，引擎记录为 missed 并在结果中标注。

参考资源

• references/批改标准详解.md — 完整批改标准、分类示例及评分应用指南
• references/指南学习_肝硬化系列.md — 5份肝硬化指南(2023-2025)系统学习笔记
• references/指南学习_胰腺胆道PPI.md — 胰腺炎/胆道/PPI指南学习笔记
• references/指南学习_IBD_HP_GERD.md — IBD/Hp/GERD指南学习笔记
• references/指南学习_乙肝DILI_BSG.md — 乙肝/DILI/BSG指南学习笔记
• references/指南学习_肝脓肿IBS功能病.md — 肝脓肿/IBS指南学习笔记
• scripts/comment_engine.py — 融合批注写入引擎（全文档遍历 + 对象模型写回 + 精确锚点）
• scripts/validate.py — 输出完整性验证 + 批注署名规范校验（python scripts/validate.py <输出文件> 消化带教老师）
• scripts/scoring_sheet.py — 打分表输出引擎（同步生成病例分析质量评估表）
• scripts/template_data.py — 内嵌官方打分表模板（附件1-4原表 base64，逐字节一致）

依赖： python-docx, lxml, openpyxl（安装：pip install python-docx lxml openpyxl）

版本记录