技能使用指南

clinical-reports(临床报告写作)Skill 能写出合规临床报告吗?

临床报告写作Skill(clinical-reports)覆盖病例报告、放射与病理诊断报告、SAE与CSR临床试验报告、SOAP与出院摘要等患者文档,内置CARE、ICH-E3模板与HIPAA、ICH-GCP合规检查,并提供去标识化扫描与结构校验脚本。本文详解一键安装、分步使用、竞品对比与典型场景体验,帮你把临床文档写快、写准、写合规,立即了解如何用AI技能提升临床写作效率。

临床报告写作Skillclinical-reports
10 个章节 约 19 分钟阅读 AI 智能生成

临床报告写作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 环境中。

安装前提

  1. 使用支持 AI 技能加载的客户端或开发环境(具体支持列表以官方说明为准)。
  2. 为技能开启文件读写与命令执行权限,否则无法调用 scripts/ 下的校验脚本、也无法把生成的示意图写入 figures/ 目录。
  3. 准备一个可写的工作目录,用于存放你的报告草稿、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 标识符是否都已处理”,本技能的结构化清单、模板资产和校验脚本能提供通用工具不具备的确定性。实际使用中两者可以配合:先用本技能搭骨架与做合规自查,再用通用工具做语言层面的润色。