药历批改技能（重症医学科 ICU）

技能版本：v3.1.3（v3.1.0 新增批改同时同步输出官方《教学药历质量评估表》打分表；v3.0.0 起批注写入统一走融合引擎 scripts/comment_engine.py——全文档遍历 + 对象模型写回 + 精确锚点三合一；基于 41 份 ICU 药历语料（23 份已批改，含 Administrator/CHEN 2024 及 hjj 2019 系列批注）+ 24 份抗感染/重症指南 + 2026 最新版教学药历质量评估表四维度评分。批改规则与评分标准同源）

触发关键词：批改药历、药历批注、ICU药历、重症药历、抗感染药历、脓毒症药历、感染性休克药历、药历评语、药历分析、药物治疗日志批改、临床药师带教

技能作者

ICU带教老师（上海交通大学医学院附属瑞金医院 重症医学科临床药师）

工作流程（SOP）

Step 1：读取药历原文

• 用 scripts/comment_engine.py 的 iter_doc_paragraphs() 全文档遍历（正文段落 + 所有表格含嵌套表格），提取所有段落文本
• 保留段落对象引用（Paragraph），以便后续定位批注插入位置

🛑 文本抽取陷阱（必读）——抽取丢字会直接导致误批！

Word/WPS 的可见字符不只存在于 <w:t>。若只用 re.findall(r'<w:t[^>]*>([^<]*)</w:t>') 抽取，
下列 run 级元素会被静默丢弃，原文随之变形：

⚠️ 另有一个隐蔽 bug：<w:t[^>]*> 会把 <w:tab/> 误认为 <w:t …> 的开标签，
一路吞到下一个 </w:t>，造成文本重复/错位。正确写法是 <w:t(?:\s[^>]*)?>。

做法：统一用 scripts/comment_engine.py 的 para_text() 取证

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)
text = CE.para_text(paragraph)   # 按文档顺序还原 <w:t> + 连字符/符号/制表/换行

强制核对规则（防止误批）

1. 抽取文本出现下列任一情形时，先怀疑丢字，不得直接下结论：
   - 「每 N 天 / 月 / 周」的 N 为多位数：每23日、每21天
   - 纯数字日期：20260823、20251027、202408
   - 术语/药名/剂量缺连字符：mgm2、5FU、LDL-C、CTCAE5
   - 文献年卷期页码连写：241256、14891496
2. 核对方法：回查该段 document.xml 是否含 <w:noBreakHyphen/>、<w:sym 等元素，或用 para_text() 重新抽取比对。
3. 在确认原文之前，严禁写出「缺连接符 / 漏字 / 笔误 / 日期格式不规范」类批注。
   —— 学员用 q12h、d1-d3、2023.09.11 表示给药频次/日期范围是常规写法，不得因此批注
4. 发现旧文本与 para_text() 结果不一致时，一律以后者为准重新判断。

Step 2：逐项核查（按下方检查清单）

按序逐一核查，记录：
- 问题位置（段落索引或区域名称）
- 问题描述（简洁、针对性）
- 批注文本（用 ICU 带教老师口吻）

⚠️ 批注位置锚定规则：
- 每条批注必须锚定到药历原文中的具体文字（commentRangeStart 需插入到对应段落），不可锚定到空白处
- 锚定文字应选取问题所在的关键句子或短语，使批注和原文的对应关系一目了然

⚠️ 正面评价规则：
- 当学员某部分书写良好时（如抗感染方案分析到位、TDM 监测完善、监护计划完整），应适当给予正面肯定
- 批注口吻参考：「这部分分析很到位，很棒」「分析正确」
- 不可只批问题，不写优点

🛑 批注依据规则：
- 每一条批注 / 评语条目都必须能明确映射到下方「药历批改检查清单」中的某一项（或评分标准中的扣分项）
- 严禁在清单之外自行发明判定标准；若确实发现清单未覆盖的问题，先作为待确认项单列，
由带教老师确认后再纳入清单，不直接写入评语
- 引用具体例子时必须核对同一份药历的原文，禁止跨文件搬运示例

🛑 质量检查点 #1（Step 2完成后必检）：
- 确认批注总数 ≥ 2 条且 ≤ 30 条；若为 0 条，提示「未检测到需批注的问题，请人工复核」；若 > 50 条，提示「批注数量偏多，请确认是否有误批或过度批注」
- 确认批注覆盖了至少 3 个检查大类（如抗感染方案 + TDM/监护 + 日志书写），避免只集中在单一维度

Step 3：插入批注（Word 原生批注气泡）

⚠️ 批注必须使用 Word 原生批注气泡形式（Comment Bubble），不可使用内嵌红色文字。

统一调用融合引擎 scripts/comment_engine.py（v3.0.0 起），三家长处合一：

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='ICU带教老师', initials='ICU带教老师',
    summary_text=评语文本, summary_label='药学带教老师评语', write_summary=True,
)
# report: {"total","inserted","missed","ambiguous","degraded","summary_written"}

融合架构三要点（替代旧 zipfile 手拼方案）：
1. 全文档遍历：iter_doc_paragraphs() 遍历正文段落 + 所有表格（递归嵌套表格）单元格段落，按 paraId 去重——修复旧版「只搜 tables[0]」的结构脆弱性与嵌套表格漏检
2. 对象模型写回：insert_comment() 通过 python-docx 官方 Comments.add_comment() 添加批注内容 + OPC 自动维护部件关系（comments.xml 自动创建/relate），不再手拼 zip / [Content_Types].xml / document.xml.rels
3. 精确锚点：find_anchor() 支持 contains/exact/startswith 三种模式 + 全文档命中计数；命中 0 → missed、命中 >1 → ambiguous、精确失败降级为前 N 字符匹配 → degraded，全部显式上报（不再静默丢批注）

技术要点：
- 锚点匹配：docx 中文字可能分散在多个 <w:r><w:t> 标签中（每字一个 run），必须用 para_text() 做 run 级完整还原后匹配，str.find() 无法跨标签匹配
- 同段落去重：同一段落只保留第一条批注，避免批注范围重叠
- 歧义策略：on_ambiguous='first' 取文档中第一个匹配段落（兼容药历「初始方案/治疗总结」重复引用同一抗感染方案的固有歧义），歧义逐条上报供追溯

Step 4：撰写带教评语（精确写入表格）

⚠️ 评语必须精确写入"药 学 带 教 老 师 评 语"表头行的下一个表格单元格内。

实现方式（v3.0.0 起由 scripts/comment_engine.py 的 write_summary_to_label() 完成，lxml 结构化解析）：
1. 遍历所有 <w:tbl>（含嵌套），拼接行内文本（run 级完整还原，去空格）精确匹配"药学带教老师评语"表头行
2. 取该行在同一 <w:tbl> 下的同级下一行（parent.index + 1）作为评语内容行
3. 只替换占位段（「对完整教学药历的评语」）之下的第一个空段落，既有非空段落一律保留，写入红色（FF0000）粗体评语段落
4. 评语结构见下方《评语模板》

> ⚠️ 嵌套表格兼容（必读）：禁止用正则 <w:tr[^>]*>.*?</w:tr> 匹配表格行——
> 嵌套表格（w:tbl in w:tc）存在时非贪婪正则会把主表格行与嵌套表格行截断/粘连。
> lxml 按父级取同级下一行，嵌套表格的行位于不同父级下，天然隔离。

⚠️ 不可仅通过搜索"评语"关键词定位，必须匹配完整的"药 学 带 教 老 师 评 语"表头行后取下一行。

Step 5：保存输出

• 输出路径：默认与输入文件同目录，命名 {原文件名}-批改.docx；用户指定输出目录时从其指定
• 用 scripts/validate.py <输出文件> ICU带教老师 验证文件完整性与批注署名合规性
• 若同名文件已存在，追加序号（如 -批改(2).docx）而非覆盖

🛑 质量检查点 #2（Step 5完成后必检）：
- 运行 python scripts/validate.py <输出文件路径> ICU带教老师，确认 commentRangeStart/End/Reference 三元素数量一致
- 署名规范校验已默认执行：不传第 2 个参数也会校验「批注 author 须以『带教老师』结尾」且「initials 与 author 一致」；传入第 2 个参数（期望署名，如 XX带教老师）可额外核对是否与本 skill 应署名一致
- 确认输出文件可在 Word 中正常打开，批注气泡可见

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

批改完成、输出批改 Word 后，同步生成对应的官方《教学药历质量评估表》打分表（附件1-3，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；在最终确认步骤中一并展示打分表路径、各维度得分与总分

边界条件与异常处理

药历批改检查清单

❌ 必须批注的问题

一、感染诊断与病原学评估（ICU 专业核心，极高频）

1.1 病原菌 / 感染部位 / 药敏（极高频）
- [ ] 是否明确最可能的病原菌及感染部位（肺、血流、尿路、腹腔、中枢等）？
- 批注口吻：「考虑什么菌感染呢」「这个患者是上尿路还是下尿路感染，结合患者具体情况分析」「大肠埃希菌脑膜炎微生物检测为何未体现？」
- [ ] 是否结合药敏结果制定/调整抗感染方案？
- 批注口吻：「药敏」「对于肺炎克雷伯菌的感染先明确药敏，确定是那种耐药感染，然后明确抗感染策略，建议查阅相关文献」
- [ ] 感染指标（PCT、CRP、WBC、体温）是否评估并动态监测？
- [ ] 培养标本（血培养/痰培养/脑脊液等）是否送检并记录结果？

1.2 经验性 vs 目标性治疗
- [ ] 经验性方案是否说明覆盖依据（社区/院内、部位、基础疾病、当地耐药）？
- [ ] 培养+药敏回报后是否降阶梯调整？

二、药品名称与用法用量规范性

2.1 药品名称通用名（重点）
- [ ] 全文药品名称是否以通用名表示？
- 规则：通用名必须出现，单独出现商品名判定违规
- 批注口吻：「商品名应改为通用名」「改成通用名」「使用通用名」
- [ ] 中英文简写首次出现是否中文说明？
- 批注口吻：「简写首次出现需中文说明」「中英文，简写及全称混乱」

2.2 用法用量具体化（高频）
- [ ] 抗菌药物是否写明具体药物 + 准确剂量（mg/g）+ 频次 + 给药途径？
- 批注口吻：「需写明准确给药剂量，mg或g」「请写明准确剂量」「请写明准确给药剂量」
- [ ] 剂量单位是否规范（mg、g、mg/kg）？是否出现「单位？」
- 批注口吻：「单位？」

2.3 注射剂溶媒规范（ICU 高频）
- [ ] 注射剂是否标注溶媒（种类+体积）？
- 批注口吻：「溶媒」「溶媒？」「剂型未交待」

2.4 剂型完整性
- [ ] 药品描述是否含剂型？
- 批注口吻：「剂型未交待」「需补充药品剂型」

三、抗感染方案分析规范（ICU 核心）

3.1 结合指南 + 药敏 + 患者（极高频）
- [ ] 抗感染方案分析是否结合指南 + 药敏 + 患者具体情况深入分析？而非大段复制说明书/指南
- 批注口吻：「结合患者具体情况分析」「应结合患者的具体情况进行分析」「需结合患者具体情况分析」「理论和实际用药结合在一起根据患者的具体病情分析」
- [ ] 是否大段抄写说明书内容、百分比数据？
- 批注口吻：「百分比数据，不是单纯抄写说明书内容，结合患者的病情，有自己的分析和思考」「理论用药？应紧密结合患者具体情况进行分析」
- [ ] 是否分析「为什么选这个药、这个剂量、这个频次」？
- 批注口吻：「单纯的药物选择对于临床药学分析不太足够」「应该有对方案的思考」「对于该患者的抗感染方案应该有自己的思考」

3.2 特殊抗菌药物细节分析（ICU 特有）
- [ ] 特殊部位感染是否分析药物穿透性？（如血脑屏障「透脑百分比」）
- 批注口吻：「透脑百分比？」
- [ ] 联合用药是否分析协同机制？
- 批注口吻：「磷霉素协同作用的分析？」「是因为抑菌剂的原因才需联合碳青霉烯的么？」
- [ ] 剂量是否结合药动学/药效学（PK/PD）与重症病理生理（分布容积增大、白蛋白低、肾功能亢进 ARC）？

3.3 肾功能不全 / 肾功能亢进剂量调整（高频）
- [ ] 经肾排泄药物是否按 CrCl/肾功能调整剂量？
- 批注口吻：「需要根据肾功能调整么？」「患者与肾功能不全么？」
- [ ] 肾功能亢进（ARC，CrCl>130）患者 β-内酰胺类是否需上调剂量/延长输注？

3.4 TDM 监测（ICU 核心）
- [ ] 万古霉素/替考拉宁/利奈唑胺/伏立康唑/氨基糖苷类是否提及血药浓度监测？
- 批注口吻：「需完善血药谷浓度监测」「有血药浓度监测数据么？」「他克莫司浓度范围是多少？」「利奈唑胺理想血药谷浓度范围2-8mg/L」
- [ ] 是否说明目标浓度范围与监测时点？

四、药学监护计划（高频错误区域）

4.1 区分疗效监护与不良反应监护
- [ ] 是否区分疗效监护与不良反应监护？
- 批注口吻：「应分成疗效监护和ADR监护」「分为疗效监护与不良反应监护」
- [ ] 疗效监护是否明确评估时点与手段（体温/感染指标/培养转阴/影像）？

4.2 监护频率与指标明确
- [ ] 每项监护是否有明确频率？是否标注具体指标？
- 批注口吻：「药学监护需注明频率」「监护频率？」
- [ ] 是否突出重点/异常指标？
- 批注口吻：「突出异常值」「重点指标应突出」「可以把重点检查突出」

4.3 ICU 特殊监护（ICU 特有核心）
- [ ] 抗感染相关：肾功能/血常规（血小板-利奈唑胺）、肝肾功能、电解质是否监护？
- 批注口吻：「不良反应需进一步完善，血液系统不良反应，肝肾功能、电解质等，并建议血药谷浓度监测」
- [ ] 危重症代谢：血糖（应激性高血糖）、应激性溃疡风险、镇静深度是否监护？
- [ ] 药物相互作用（抗感染药 vs 他克莫司/环孢素等免疫抑制剂、MAO 抑制等）是否分析？
- 批注口吻：「是临床相关的相互作用么？」

4.4 监护结果跟踪
- [ ] 制定的监护计划是否在后续日志中跟踪结果？
- 批注口吻：「制定的药学监护计划，在后续监护结果中应有体现」

五、药物治疗日志规范（ICU 特有：危重患者每日记录）

5.1 危重患者日志频次
- [ ] 危重患者是否每日记录（而非 3 天一次）？病情变化/抢救是否随时记录？
- 批注口吻：「危重症患者应每日记录」

5.2 避免重复复制（高频）
- [ ] 日志是否仅记录变化与异常（"余无殊"）？
- 批注口吻：「总结不是照抄」「可总结精炼下」「写得很长跟患者实际关系不大」「重复了」「与"初始药物分析"重复」
- [ ] 总结是否精简？
- 批注口吻：「总结应精简」「总结不是照抄」

5.3 分析与实际用药对应
- [ ] 日志分析与当日实际用药是否对应？
- 批注口吻：「分析应围绕当日实际用药展开」「可具体分析」

5.4 病情变化时的分析
- [ ] 病情变化/用药变更时是否有详尽分析、判断、处理及结果记录？
- 批注口吻：「后续有发什么」「阶段小结分析？」

六、ADR / 相互作用 / 特殊人群

6.1 ADR 因果判断
- [ ] 出现疑似 ADR 时，是否做时序性、去激发、再激发、转归分析？
- 批注口吻：「应该不排除美罗培南引起的，有血药浓度监测数据么？」「结合患者情况分析主要不良反应」
- [ ] 抗菌药物常见 ADR（万古霉素红人综合征/肾毒性、利奈唑胺血小板减少、碳青霉烯神经毒性、氨基糖苷耳肾毒性）是否识别？

6.2 药物相互作用
- [ ] 潜在相互作用是否分析临床意义？

6.3 特殊人群
- [ ] 老年、肝肾功能不全、肥胖、透析患者是否个体化剂量调整？
- [ ] 免疫抑制/移植患者抗感染与免疫抑制剂的相互作用是否分析？

七、检查检验与书写规范

7.1 检查检验筛选（ICU 高频）
- [ ] 检查检验是否筛选保留重要/阳性指标、突出异常值？
- 批注口吻：「和患者相关的留下，精简」「检查检验指标需筛选」
- [ ] 检查项目是否标注日期与具体数值、单位？

7.2 书写规范
- [ ] 表述是否专业（避免口语化）？
- 批注口吻：「太口语化，浅显」
- [ ] 药品分类是否清晰？
- 批注口吻：「排列混乱，可考虑按照药理作用分类」
- [ ] 结构是否按重要程度排序？
- 批注口吻：「按照重要程度排下顺序」

✅ 不予批注的内容（明确豁免）

⚠️ 避免多余批注：AI仅对药历中实际存在的问题进行批注，不应对老师未关注的细节额外添加批注。

评分规则（2026最新版教学药历质量评估表）

四维度ABCD等级评分（总分100分）

各维度评估要点（官方评估表原文）

基本要求（30分）：①药历书写应字迹工整、客观、真实、准确、及时、完整；②应当使用医药学术语，使用药品通用名称；③应当表述准确，语句通顺，标点正确；④教学药历应有一年期师资的修改和评语。

教学药历首页（30分）：①药历首页表格中不应有缺漏项；②主诉、现病史完整清晰，阳性体征及实验室、影像、特殊检查结果简洁明了，既往史与用药史详尽描述，如有院前抢救史应清楚记录；③对患者既往出现过的药品（食品）过敏反应，及发生过的药物不良反应详细具体描述；④对药物治疗方案的分析应逻辑顺畅，依据充分；⑤药学监护计划部分应有明确的监护内容、监测指标和监测周期。

治疗日志部分（30分）：①应按规定日期书写日志，首次药物治疗记录应于患者入院48小时内完成，日志通常3天写一次，危重症患者应每日记录，治疗方案有重大调整或病情危重有抢救时应随时记录；②日志写作应完整通顺，疾病发展变化描述清晰准确，不应遗漏主要的阳性体征和阳性结果；③应对初始药学监护计划的执行记录与监护结果进行记录，如有用药变更，应制订新的药学监护方案；④如有病情变化与用药变更时应有详尽的分析、判断、处理及结果记录；⑤应对异常的实验室等辅助检查结果进行分析，提出药学处理建议；⑥记录临床药师参与药物治疗情况；⑦应有出院药物治疗方案。

总结（10分）：①应对本次入院药物治疗过程进行总结；②对患者药物治疗过程中的主要问题和处理过程进行分析评价；③对临床药师在本次治疗过程中的作用进行总结；④应有对患者出院后继续服药的用药指导，同时有对患者自行监测的辅导；⑤对需要的患者制订随访计划，制定明确的随访要求，包括门诊随诊时间及随诊项目。

评分等级

评分方法

1. 逐维度评估：对照各维度评估要点，结合检查清单中发现的缺陷数量和严重程度，确定每个维度的ABCD等级及对应得分
2. 汇总得分：4维度得分相加=总分（满分100分）
3. 确定等级：根据总分对应优秀/合格/不合格
4. 重度缺陷检查：若存在重度缺陷，直接判定不合格

重度缺陷（出现任一直接不合格）

①字迹潦草难以辨认、不能通读 ②有证据证明系拷贝行为导致的原则性错误 ③带教老师无评语 ④药物名称未使用通用名出现≥5处

检查清单与四维度对应关系

评语模板

药历书写认真，体现了一定的临床思维和药学分析能力。
存在以下问题，请修改完善：
1. [问题1]
2. [问题2]
（视情况写2-4条，每条简明扼要）

接收时间：XXXX年X月X日
批改时间：XXXX年X月X日
ICU带教老师

评语要求：
- 开头先肯定（真实、不夸大）
- 问题条目聚焦，不超过4条，优先选最重要的（ICU药历通常优先：抗感染方案结合药敏/患者 → TDM 监测 → 肾功能剂量调整 → 监护/日志书写）
- 语气：直接、专业、带教风格，不苛刻
- 字体颜色：红色（Word RGB: FF0000）
- 签名固定为"ICU带教老师"

批注措辞模板库（按场景）

> 完整模板详见 references/批注措辞模板.md（ICU 专业场景，含具体措辞和豁免规则）
> 批改时根据检测到的问题类型查表获取标准批注措辞

快速索引

常见病种/场景批改要点

> 完整知识详见 references/ICU病种批改要点.md（覆盖脓毒症/感染性休克、重症肺炎、多重耐药菌感染、颅内感染、腹腔感染、尿路感染、真菌感染、诺卡菌病等 ICU 常见场景，含关键病原菌与抗感染策略、TDM 与监护点）
> 批改时根据患者诊断加载对应场景的批改要点

场景索引

学员常见错误类型

> 详见 references/常见错误类型.md（基于 23 份已批改 ICU 药历归纳）

文件操作规范

• 批改文件默认与输入文件同目录保存（不写死绝对路径，便于任意环境即装即用）
• 命名规范：{原文件名}-批改.docx
• 批注作者统一填写：ICU带教老师
• 核心脚本：scripts/comment_engine.py（融合批注写入引擎：全文档遍历 + 对象模型写回 + 精确锚点）、scripts/validate.py（输出完整性验证）、scripts/scoring_sheet.py（打分表输出引擎）
• 打分表模板：内嵌于 scripts/template_data.py（官方附件1-3原表 base64，逐字节一致；技能包内不再携带 .xlsx）
• 评分标准：references/评分标准.md（四维度ABCD等级评分+ICU专用详细扣分项）
• 指南要点：references/抗感染与ICU指南要点.md（与抗感染专业共享的参考指南库）
• 批量批改后必须运行 scripts/validate.py <输出文件> ICU带教老师 验证每个输出文件的完整性与署名合规性
• （可选）若当前工作区存在 .workbuddy/memory/ 目录则追加批改日志，否则跳过
• 环境依赖：python-docx, lxml, openpyxl（安装：pip install python-docx lxml openpyxl）

版本记录