临床报告写作Skill:让病例报告、诊断报告与临床文档写得快、写得合规
核心结论速览
- 一份技能覆盖四大类临床文档:期刊病例报告(CARE 指南)、放射/病理/实验室诊断报告、临床试验报告(ICH-E3、SAE、CSR)、患者文档(SOAP、H&P、出院摘要)都能写。
- 内置"合规护栏"而非只管生成文字:技能详情明确要求遵守 HIPAA、FDA 与 ICH-GCP,并提供 18 项 HIPAA 标识符的去标识化检查思路与脚本。
- 模板 + 校验脚本双保险:
assets/下提供 12 套可直接套用的报告模板,scripts/下提供 CARE 合规校验、ICH-E3 结构校验、去标识化扫描等自动化工具。 - 强制图文并茂:技能要求每份临床报告至少包含 1 张 AI 生成示意图(如患者时间线、诊断算法流程图、CONSORT 流程图),可通过
scientific-schematics技能产出出版级图件。 - 适合医生、医学生、医学写作者与临床研究团队:把"从空白文档开始写"变成"按结构与检查表填内容并自动体检"。
1. 该技能叫什么?如何一键安装 AI 技能提升开发效率?
技能中文名:临床报告写作Skill 技能英文名:clinical-reports 技能ID:11980
它解决什么问题
临床文档写作长期存在三个痛点:慢、不统一、易踩合规红线。
- 慢:一份符合 CARE 指南的病例报告,从文献检索、结构搭建到去标识化处理,往往要耗费医生数个工作日;一份 SAE 报告还有 7 天 / 15 天的法定上报时限压力。
- 不统一:不同科室、不同年资的医生写出的 SOAP 笔记与诊断报告结构差异极大,放射科的结构化报告(Lung-RADS、BI-RADS、LI-RADS、PI-RADS)更容易遗漏关键字段。
- 易踩红线:18 项 HIPAA 标识符漏删一个(例如具体日期、机构名称、面部照片),就可能导致稿件被期刊直接退回甚至引发隐私纠纷。
临床报告写作Skill 的定位,是把"报告结构、监管要求、检查表"这三件事固化成可复用的技能能力:你负责提供真实的临床信息,技能负责把它们组织成符合规范的报告骨架,并提醒你哪里还缺东西。
一键安装的思路与步骤
该技能声明可使用的工具为 Read、Write、Edit、Bash,这意味着它需要运行在一个支持技能(Skill)机制、且具备文件读写与命令行执行权限的 AI 客户端或 Agent 环境中。
安装前提
- 使用支持 AI 技能加载的客户端或开发环境(具体支持列表以官方说明为准)。
- 为技能开启文件读写与命令执行权限,否则无法调用
scripts/下的校验脚本、也无法把生成的示意图写入figures/目录。 - 准备一个可写的工作目录,用于存放你的报告草稿、
figures/图件输出与assets/模板副本。
安装入口
在技能市场或技能管理界面中,按中文名「临床报告写作Skill」或英文名 clinical-reports 检索并添加;部分环境也支持通过技能ID 11980 定位。具体安装命令、目录位置与启用方式,以官方说明为准。
验证是否生效
安装完成后,用一句最简指令做冒烟测试,例如:
“帮我按 CARE 指南列出一份病例报告的必备章节清单。”
如果技能已生效,它应当返回包含标题、关键词、摘要、引言、患者信息、临床发现、时间线、诊断评估、治疗干预、随访与结果、讨论、患者视角、知情同意等要素的结构化清单,而不是泛泛而谈的通用写作建议。你也可以进一步让它读取 assets/case_report_template.md,以确认文件访问权限正常。
2. 该技能的主要功能和特点
(1)四大类临床报告全覆盖
- 病例报告:严格对齐 CARE 指南,从标题(须含"病例报告"字样)、2-5 个 MeSH 关键词、150-250 字摘要,到时间线、诊断评估、讨论与患者视角,逐项覆盖。
- 诊断报告:放射学报告按"患者信息—临床指征—技术—比较—发现—印象"六段式结构;病理学报告覆盖大体描述、镜下描述、诊断与 CAP 同步报告要素(Breslow 厚度、Clark 级别、切缘、淋巴结、TNM 分期等);实验室报告覆盖结果、参考范围、异常标记(H/L)与危急值通知记录。
- 临床试验报告:SAE 报告包含研究信息、受试者信息、事件信息、因果关系评估、采取的行动、预期性、叙述、报告者信息八大组件,并给出 7 天 / 15 天的监管时限提示;CSR 按 ICH-E3 的 12 个主要部分组织。
- 患者文档:SOAP 笔记(主观/客观/评估/计划)、H&P(含 OPQRST 问诊记忆法与 10-14 个系统的系统回顾)、出院摘要(含出院用药、处置、随访计划与患者指导)。
(2)合规能力内建,而不是事后补
技能把 HIPAA 安全港方法的 18 项标识符清单、FDA 21 CFR Part 11/50/56/312、ICH-GCP 的源文档与审计追踪要求写进了正文,并配套 assets/hipaa_compliance_checklist.md 与 scripts/check_deidentification.py 用于实操层面自查。
(3)模板资产开箱即用
assets/ 目录提供病例报告、放射学报告、病理学报告、实验室报告、SAE、CSR、SOAP、H&P、出院摘要、会诊笔记等模板,以及通用质量检查表与 HIPAA 合规检查表,避免每次都从零搭骨架。
(4)八个自动化脚本做"体检"
validate_case_report.py:检查 CARE 指南合规性与完整性validate_trial_report.py:验证 ICH-E3 结构与必需元素check_deidentification.py:扫描文本中的 18 个 HIPAA 标识符format_adverse_events.py:从数据生成不良事件汇总表generate_report_template.py:交互式模板选择与生成extract_clinical_data.py:从报告中解析结构化数据compliance_checker.py:验证法规合规要求terminology_validator.py:验证医学术语与编码
(5)强制配图,提升发表与沟通效果
技能明确规定每份临床报告至少包含 1 张由 scientific-schematics 技能生成的示意图,并给出调用方式(命令示例来自技能详情):
python scripts/generate_schematic.py "your diagram description" -o figures/output.png
适用图件包括患者时间线、诊断算法流程图、治疗协议工作流、解剖示意图、CONSORT 参与者流程图、不良事件分类树等。
(6)术语与缩写纪律
技能内置 SNOMED CT、LOINC、ICD-10-CM、CPT 的用途说明,并明确列出"不使用清单":不要写 U、IU、QD、QOD,不要写尾随零(X.0 mg),不要省略前导零(.X mg),不要用 MS / MSO4 / MgSO4 这类易混淆缩写。
和普通写作工具比强在哪:普通工具给你"流畅的文字",这个技能给你"能被期刊接受、能被监管机构审阅、能通过机构质控的结构"。它更像一位懂 CARE 和 ICH-E3 的医学写作搭档,而不是通用文案助手。
3. 如何使用该技能?
步骤一:明确报告类型与目标场景
先告诉技能你要写哪一类、给谁看。例如:“我要写一份投稿中文核心期刊的病例报告”“我要写一份胸部 CT 增强的放射学报告”“我要为 III 期试验写一份 SAE 初始报告”。类型不同,技能加载的指南与模板完全不同。
步骤二:让技能生成或匹配模板骨架
可直接要求:"请用 assets/case_report_template.md 的结构,为我搭一份病例报告骨架,先只输出章节标题和每节需要填写的信息项。“这一步能迅速看清"我还缺哪些信息”,避免写到最后才发现漏了知情同意声明。
步骤三:提供真实临床信息,逐节填充
输入要具体。以 SOAP 笔记为例,你可以这样给素材:
主观:患者诉近 3 天活动后呼吸困难加重,否认胸痛、发热、咳嗽。 客观:体温 98.6°F,血压 142/88,心率 92,呼吸 22,室内空气 SpO₂ 91%;双肺底湿啰音;双下肢 2+ 凹陷性水肿。 请据此写出 S、O 两段,并给出 A(评估)与 P(计划)的候选内容。
技能会输出规范的 S/O 段落,并在 A 段给出如"急性失代偿性心力衰竭,NYHA III 级 / 高血压控制不佳 / 慢性肾病 3 期"这样的编号问题列表,在 P 段给出诊断计划、治疗计划、患者教育与随访安排——这正是技能详情中示范的结构。
步骤四:补齐合规动作
明确要求:"请按 18 项 HIPAA 标识符清单扫描以下文本,标出所有需要移除或模糊处理的位置,并给出替换建议(如’60 多岁的女性’‘3 个月前’)。"对于病例报告,还要补上知情同意声明,技能给出的标准表述是:获得患者对病例报告及相关图像发表的书面知情同意,副本可供期刊主编审查。
步骤五:生成至少一张示意图
描述你想要的图,例如"画一张该患者从入院到 3 个月随访的临床进展时间线,标注第 0 天症状出现、第 2 天 CT 检查、第 5 天开始用药、第 14 天临床改善、第 3 个月完全缓解",然后调用脚本输出到 figures/ 目录。
步骤六:跑校验脚本,按报告逐项过关
用 validate_case_report.py 查 CARE 完整性,用 check_deidentification.py 查隐私,用 terminology_validator.py 查术语与编码,用 compliance_checker.py 查法规项。最后对照技能给出的"最终检查表"逐条打勾:必需部分是否齐全、隐私是否保护、是否取得知情同意、数据是否准确、格式是否符合指南、签名与日期是否存在。
4. 同类型竞品对比分析
| 方案名称 | 定位 | 核心功能 | 安装/使用门槛 | 适用场景 | 优势与不足 |
|---|---|---|---|---|---|
| 临床报告写作Skill(clinical-reports) | 面向临床与科研写作的专用 AI 技能 | 四大类报告结构生成、CARE/ICH-E3 模板、HIPAA 去标识化检查、8 个校验脚本、强制 AI 配图 | 需支持技能机制的 AI 环境并开放文件读写与命令执行权限;具体安装方式以官方说明为准 | 病例报告投稿、结构化诊断报告、SAE/CSR 撰写、日常病历与出院摘要 | 优势:结构 + 合规 + 脚本校验一体化,报告类型覆盖最全;不足:需要使用者提供真实临床信息,无法替代医生的临床判断,环境权限配置有一定门槛 |
| 通用大模型对话工具 | 通用文本生成助手 | 自由问答、段落润色、简单模板复述 | 门槛最低,打开即用 | 快速起草思路、语言润色、翻译 | 优势:上手零成本;不足:不了解 CARE 与 ICH-E3 的逐项要求,不主动做 18 项标识符扫描,容易生成"看起来专业但缺关键字段"的文本 |
| 医院电子病历(EMR)内置模板 | 机构级临床文档系统 | 结构化字段录入、自动带入生命体征与检验值、科室模板 | 由机构统一部署,个人无法自行安装 | 院内日常病程记录、入院记录、出院小结 | 优势:与院内数据打通、符合机构规范;不足:模板僵化、不面向期刊投稿与监管提交,无法生成 CONSORT 图或做 CARE 合规校验 |
| 人工医学写作/编辑服务 | 外包专业写作与润色 | 全流程代写、同行评审级润色、期刊格式适配 | 需商务对接,周期与费用较高 | 高影响力期刊投稿、注册申报资料 | 优势:质量上限高、可承担复杂 CSR;不足:成本高、周期长,不适合日常高频的 SOAP 与诊断报告 |
选型建议:日常高频、结构固定的文档(SOAP、H&P、出院摘要、放射报告)优先用本技能把效率拉起来;面向监管提交的复杂 CSR,可用本技能产出 ICH-E3 结构骨架与初稿,再交由专业医学写作者复核。
5. 该技能的典型应用场景与实际体验情况
场景一:临床医生把罕见病例写成可投稿的病例报告
- 角色与痛点:三甲医院主治医师遇到一例"年轻患者急性心肌梗死的不寻常表现",想投稿但不知道 CARE 指南要求哪些章节,也担心影像资料泄露隐私。
- 使用方式:先让技能输出 CARE 全章节清单并套用
assets/case_report_template.md,再逐节填入病史、检查、治疗与随访;用check_deidentification.py扫描草稿,把"2023 年 4 月 12 日"改为"约 3 个月前"、把姓名替换为"患者";最后生成一张临床进展时间线图。 - 实际体验:上手难度低,因为技能把"该写什么"变成了清单式任务。需要注意:讨论部分的新颖性论证与文献比较仍需作者本人完成,技能提供的是结构与规范,不提供你所在领域的文献检索结论。
场景二:放射科与病理科医生写结构化诊断报告
- 角色与痛点:放射科医生日均报告量大,磨玻璃影、肺结节随访建议等表述不统一;病理科医生写黑色素瘤报告时容易漏掉 Breslow 厚度或切缘距离。
- 使用方式:按"患者信息—临床指征—技术—比较—发现—印象"六段式生成骨架,发现段按器官系统填写;病理报告则要求技能按 CAP 同步报告要素逐项提示(肿瘤部位、大小、组织学类型与分级、淋巴血管侵犯、神经周围侵犯、切缘、淋巴结、TNM 分期)。
- 实际体验:结构化程度高,尤其适合需要纵向对比的复查病例——技能明确要求设置"比较"段落,避免"未复查既往影像"这类常见缺陷。注意:模版只是骨架,具体征象描述仍必须由医生基于图像亲自判断。
场景三:临床试验团队赶 SAE 与 CSR 时限
- 角色与痛点:CRO 的医学写作者需要在 7 天内提交致命或威胁生命的意外 SAE 初始报告、15 天内提交完整报告,同时保证因果关系评估与预期性判断不乱。
- 使用方式:用 SAE 八大组件清单逐项填写,用"无关/不太可能/可能/很可能/确定"五级因果关系量表做评估,用
format_adverse_events.py从数据生成不良事件汇总表,用validate_trial_report.py检查 ICH-E3 结构。 - 实际体验:清单式提示对时限管理帮助明显,能减少"漏填预期性判断"这类退回重写的返工。注意:脚本校验只能查结构完整性与要素缺失,不能替代申办方与 IRB 的实质审阅。
场景四:住院医师规范化书写 SOAP、H&P 与出院摘要
- 角色与痛点:规培医生写病程记录耗时,且容易出现"复制粘贴传播过时信息""未记录医疗必要性影响计费"等问题。
- 使用方式:用 OPQRST 记忆法组织现病史,用 10-14 个系统做系统回顾,用编号问题列表写评估与计划;出院摘要则围绕住院经过、出院诊断、出院用药变更、出院状况与随访计划展开。
- 实际体验:对低年资医生是很好的"写作脚手架",能显著减少结构遗漏。需特别注意:技能明确提示要避免推测性表述、要签名与注明日期,这些都是真实质控中最常被扣分的地方。
6. 该技能能为用户带来的价值
效率价值:把"构思结构 + 回忆规范 + 逐项自查"三段工作合并为一次结构化生成。以病例报告为例,技能覆盖从标题到知情同意的全部章节,作者可以把精力集中在临床信息的准确性上,而不是反复翻阅投稿须知。SAE 报告的场景收益更直接——7 天 / 15 天的时限压力下,少一次返工就多一分合规余量。
门槛价值:CARE 指南、ICH-E3、CAP 同步报告、HIPAA 18 项标识符、ICH-GCP 这些规范,过去要靠导师带教或自己啃文档才能掌握;现在它们被固化成模板、检查表与脚本,医学生与低年资医生也能写出结构完整的初稿。
风险控制价值:18 项标识符扫描、术语与缩写不使用清单、最终检查表三重把关,把隐私泄露与格式退稿这两类高频风险前置拦截。技能特别点名了常见陷阱:去标识化不足、因果关系评估不完整、临界值通知延迟、复制粘贴错误、缺失签名——这些都是真实质控中的扣分项。
长期价值:技能与 scientific-schematics、科学写作、同行评审、引用管理、文献综述等能力可组合使用,形成"写作—配图—评审—引用"的完整链路。团队层面,统一的结构化模板还能提升科室文档的一致性与可审计性。
7. 常见问题 FAQ
Q1:这个技能怎么安装?需要什么前提条件?
在支持 AI 技能机制的客户端中按名称「临床报告写作Skill」或英文名 clinical-reports 检索添加即可,也可尝试用技能ID 11980 定位。前提是运行环境允许该技能使用 Read、Write、Edit、Bash 工具,并能访问工作目录中的 assets/、scripts/、references/ 等资源。具体安装命令与启用路径以官方说明为准。安装后建议先用"CARE 指南必备章节清单"做一次冒烟测试验证是否生效。
Q2:使用这个技能收费吗?
技能本身的功能说明中未包含任何定价信息,是否收费取决于你使用的 AI 客户端或技能平台的计费策略,请以官方说明为准。需要额外注意的是,技能要求每份报告至少生成一张示意图,若该绘图能力由独立技能提供,其调用是否计费同样以对应平台的官方说明为准。
Q3:这个技能适合谁用?我不写论文,只写日常病程记录有用吗?
除了面向期刊投稿的病例报告,技能同样覆盖放射/病理/实验室诊断报告与 SOAP、H&P、出院摘要等患者文档,因此临床一线的日常书写同样适用。目标用户包括临床医生、住院医师与规培生、医学写作者、临床试验协调员与研究者、医学生,以及需要准备监管提交材料的注册团队。
Q4:它能保证我的报告一定通过期刊或监管审阅吗?
不能。技能提供的是符合 CARE、ICH-E3、CAP、HIPAA、ICH-GCP 等标准的结构与检查清单,以及形如 validate_case_report.py、compliance_checker.py 的结构性与合规性校验。它可以大幅减少"缺章节、漏要素、隐私未处理"这类问题,但临床判断的准确性、病例本身的新颖性、统计分析的严谨性仍需作者本人负责。工具校验不能替代机构质控与伦理审查。
Q5:和通用大模型直接对话相比,我该选哪个?
如果你只是需要语言润色或快速起草一段文字,通用对话工具足够;但如果你需要"照 CARE 指南逐项写病例报告"“照 ICH-E3 组织 CSR”“确认 18 项 HIPAA 标识符是否都已处理”,本技能的结构化清单、模板资产和校验脚本能提供通用工具不具备的确定性。实际使用中两者可以配合:先用本技能搭骨架与做合规自查,再用通用工具做语言层面的润色。