技能使用指南

clinical-reports（临床报告写作）Skill 能一键生成合规临床报告吗？

临床报告写作Skill 覆盖病例报告（CARE）、放射病理实验室诊断报告、SAE 与 CSR（ICH-E3）及 SOAP、H&P、出院摘要，内置模板、去标识化核查与校验脚本，帮医师与研究者减少漏项、降低合规风险。看它如何安装与使用，快速上手规范化写作。

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

临床报告写作Skill：把 CARE、ICH-E3、HIPAA 变成可执行的写作流水线

  • 一个技能覆盖四大类临床文档：病例报告、诊断报告（放射/病理/实验室）、临床试验报告（SAE、CSR）、患者文档（SOAP、H&P、出院摘要），并内置各类型模板与检查清单。
  • 合规不是口号，而是可执行的检查项：内置 18 项 HIPAA 标识符去标识化核查、FDA 21 CFR 与 ICH-GCP 要点、CARE 与 ICH-E3 结构验证脚本。
  • 写作 + 出图 + 校验一条链路：技能要求每份临床报告至少配一张由「科学示意图」能力生成的出版级图表，如病例时间线、CONSORT 流程图、诊断算法图。
  • 面向真实作业流程设计：提供可直接套用的模板资产与自动化脚本，从草稿到定稿都有对应步骤，而不是只给一段泛泛的写作建议。
  • 适合临床医师、研究者、医学写作与医学事务人员：把「记得写什么」变成「按清单逐项交付」，显著减少返工与合规风险。

1. 该技能叫什么？如何一键安装 AI 技能提升开发效率？

技能基本信息

项目 内容
技能中文名 临床报告写作Skill
技能英文名 clinical-reports
技能ID 13098
技能定位 按国际规范撰写、校验临床报告的专业写作技能
可用工具 Read、Write、Edit、Bash

它解决什么问题

临床文档的真正难点，往往不在于「写不出字」，而在于任务复杂：病例报告要符合 CARE 清单，放射报告要有结构化段落，SAE 报告有 7 天/15 天的监管时限，CSR 要按 ICH-E3 的十几个章节组织，患者文档还要兼顾计费与法务。不同文档类型的结构、术语、隐私要求各不相同，靠记忆和零散模板极易漏项。这个技能把这些「隐性规范」整理成可执行的流程、模板与校验脚本，让 AI 助手按专业标准产出初稿，并主动提示去标识化与合规风险。

一键安装的思路与步骤

  1. 确认环境前提：运行环境需支持该技能声明的 Read、Write、Edit、Bash 四类工具能力，这样才能读取模板、写入文档、调用校验脚本。具体支持范围以官方说明为准。
  2. 找到技能入口：在所使用的 AI 技能市场/技能库中检索技能英文名 clinical-reports，或直接检索技能ID 13098。不同平台的入口名称与操作路径不同，以官方说明为准。
  3. 执行安装：在技能详情页点击安装/启用；若是本地技能目录模式，则按官方文档将技能文件放入指定目录。安装命令、目录路径等细节以官方说明为准。
  4. 验证是否生效：安装后向助手提出一个可验证的请求，例如「用 clinical-reports 技能列出可用的报告模板与校验脚本」。若返回 assets/ 下的病例报告、放射报告、病理报告、SAE、CSR、SOAP、H&P、出院摘要等模板，以及 scripts/ 下的校验脚本清单，说明技能已正确加载。
  5. 跑通一次最小流程：用一个虚构病例让技能生成一份 SOAP 记录草稿，确认它能按 S/O/A/P 四段输出，再逐步过渡到真实任务。

安装完成后无需额外配置，直接在对话中描述任务即可触发技能能力。

2. 该技能的主要功能和特点

四大报告类别全覆盖

  • 病例报告（CARE 指南）：从标题、关键词、结构化摘要到时间线、诊断评估、治疗干预、随访结果、讨论与患者视角，逐节给出写作要求与范例句式。
  • 诊断报告：放射学报告按患者信息、临床指征、技术、对比、发现、印象六段式组织；病理报告包含大体描述、镜下描述、诊断、切缘与淋巴结状态、CAP 同步报告要素；实验室报告包含参考范围、异常标记与危急值通报记录。
  • 临床试验报告：SAE 报告的严重性判定标准、因果关系五级评估、预期性判断、叙述写法与监管时间线；CSR 按 ICH-E3 章节结构展开；方案偏离分级与 CAPA 记录要求。
  • 患者文档：SOAP 记录、H&P（含 OPQRST 问诊助记与系统回顾）、出院摘要（含出院用药、出院状况、随访计划）、会诊记录。

差异化特点

  1. 清单式而非散文式：CARE 清单、ICH-E3 章节、HIPAA 18 项标识符都以可勾选条目呈现，便于逐项核对，减少漏项。
  2. 强制图表环节：技能明确要求每份临床报告至少包含一张由「科学示意图」能力生成的图表，可用命令 python scripts/generate_schematic.py "您的图表描述" -o figures/output.png 生成病例时间线、诊断算法、治疗流程、CONSORT 参与者流程图等，输出到 figures/ 目录。
  3. 自带校验脚本：validate_case_report.py 检查 CARE 合规性与完整性，validate_trial_report.py 验证 ICH-E3 结构与必需元素，check_deidentification.py 扫描 18 项 HIPAA 标识符，compliance_checker.py 与 terminology_validator.py 分别核验监管要求与术语编码，format_adverse_events.py 可从数据生成不良事件汇总表。
  4. 模板可直接调用：assets/ 下提供十余套成品模板，从放射报告到出院摘要一应俱全，避免每次从零搭建骨架。
  5. 术语与缩写规范内置：涵盖 SNOMED CT、LOINC、ICD-10-CM、CPT 的用途说明，并列出「不使用缩写清单」（如不写 U、IU、QD、QOD，不写尾随零、必须写前导零，不写 MS/MSO4/MgSO4 而写全称），这类细节恰恰是审稿与合规检查中最容易被挑出的问题。
  6. 常见陷阱预警：针对四类文档分别列出高频错误，如病例报告的去标识化不足与过度外推、诊断报告的模糊表述与危急值延迟、试验报告的选择性报告、患者文档的复制粘贴错误。

3. 如何使用该技能？

第 1 步：明确报告类型与目标

先告诉助手属于哪一类文档，例如「我要写一份投稿用的病例报告」「我要写一份胸部 CT 的结构化放射报告」「我要写一份 SAE 叙述」。类型不清时，技能可能给出通用框架，针对性会下降。

第 2 步：提供必要的临床要素

按技能要求补齐输入。以病例报告为例，需要：患者人口学信息（用于去标识化处理）、主诉与现病史、症状时间线、诊断检查与结果、治疗与剂量、随访结局、是否已获得发表知情同意。

输入示例：

用 clinical-reports 技能起草一份病例报告初稿。要点如下：60 多岁男性，因「活动后气促 3 天」就诊；第 0 天门诊发现双下肺湿啰音，SpO₂ 91%；第 1 天查 BNP 升高、胸片示肺淤血，考虑急性失代偿性心力衰竭；第 2 天起利尿治疗，症状缓解；第 14 天复诊体重下降、活动耐量改善。已签署发表知情同意。请按 CARE 指南组织，并在涉及日期、姓名处做去标识化处理。

第 3 步：套用模板生成结构与正文

技能会调用 assets/ 下对应模板（如病例报告模板、放射报告模板、SOAP 模板）搭建骨架，再逐节填充内容。可要求它单独输出某一节，例如「只重写讨论部分，重点说明本病例与既往文献的差异」。

第 4 步：生成配图

按技能要求补充至少一张示意图。例如生成患者时间线图，命令形式如下，输出会保存在 figures/ 目录：

python scripts/generate_schematic.py "患者从就诊到 3 个月随访的临床时间线，标注诊断节点与治疗起始点" -o figures/timeline.png

第 5 步：运行校验脚本

  • 病例报告：python scripts/validate_case_report.py
  • 试验报告：python scripts/validate_trial_report.py
  • 隐私核查：python scripts/check_deidentification.py

根据脚本提示补齐缺失字段。注意脚本的具体参数与调用方式以技能目录内说明为准。

第 6 步：合规与术语复核

用 compliance_checker.py 核对监管要点，用 terminology_validator.py 检查术语与编码写法是否规范，并对照 assets/quality_checklist.md 与 assets/hipaa_compliance_checklist.md 做最终确认。

输出说明： 技能产出的是一份结构化草稿，包含各必需章节、可勾选的检查清单、待补充项标注以及配图建议，供你在此基础上做专业判断与修改。

4. 同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
临床报告写作Skill（clinical-reports） 按国际规范产出并校验临床文档的专业技能 CARE/ICH-E3/CAP/ACR 结构模板、SAE 与 CSR 框架、HIPAA 去标识化核查、校验脚本、强制配图 需支持 Read/Write/Edit/Bash 的运行环境，安装后即用 病例报告投稿、结构化诊断报告、临床试验文档、日常病历书写 优势：规范内嵌、模板与脚本齐全、合规检查自动化和术语规则细；不足：仍需专业人员审核，脚本需在支持的终端环境运行
通用 AI 助手（通用对话模型） 通用文本生成 可写任意文体，响应灵活 门槛最低，开箱即用 头脑风暴、快速草稿、非正式文书 优势：上手快、成本低；不足：不熟悉 CARE/ICH-E3 的具体章节要求，缺少模板与校验机制，隐私风险需自行把关
医院信息系统/结构化报告模板 机构级临床文档基础设施 结构化录入、术语字典、报告分发与归档 需机构采购与部署，与院内系统深度绑定 院内日常诊断报告、电子病历记录 优势：与工作流无缝集成、权限与审计完善；不足：面向发表与监管提交的文档（如病例报告、CSR）支持有限，灵活性差
手工撰写 + 期刊模板 + 同行评审 传统写作路径 依赖作者经验、期刊作者指南与同事评审 无安装门槛，但时间与人力成本高 高质量论文级病例报告 优势：专业判断充分、表达打磨到位；不足：耗时数周，结构漏项常在评审阶段才暴露，去标识化依赖人工核对

如何选择： 如果每天要产出大量结构化诊断报告，院内系统仍是主力；如果面向期刊投稿或监管提交，需要同时兼顾规范结构与合规核查，则临床报告写作Skill 的模板加脚本组合更贴合；通用 AI 助手适合作为轻量补充。

5. 该技能的典型应用场景与实际体验情况

场景一：影像科医师的结构化报告与危急值提示

角色：放射科医师。痛点：日常报告量大，用词不统一，危急发现容易遗漏记录。使用方式：给出检查部位、对比剂使用、关键影像所见，技能按「患者信息—临床指征—技术—对比—发现—印象」六段式输出，并按器官系统罗列阳性发现与相关阴性。实际体验：上手难度低，输出段落顺序稳定，减少「想到哪写到哪」；注意印象部分需自己核对结论强度（如「符合」「不能排除」的措辞），不宜直接照搬。

场景二：临床研究者撰写 SAE 报告

角色：临床试验协调员/研究者。痛点：SAE 报告有严格时限（致命或危及生命的意外事件通常为 7 天初步报告、15 天完整报告，其他严重意外事件 15 天，以适用法规与机构政策为准），且需完整记录因果关系、预期性、采取措施与叙述。使用方式：输入事件起止时间、严重性判定依据、与研究干预的关系评估，技能按研究信息、受试者信息、事件信息、因果关系、采取措施、预期性、叙述、报告者信息八段输出。实际体验：结构完整度高，叙述部分条理清晰；注意因果关系分级必须由研究者判断，技能的输出只是组织建议。

场景三：低年资医师与医学生撰写首篇病例报告

角色：住院医师/研究生。痛点：不清楚 CARE 指南要求哪些章节，时间线不会画，讨论部分容易写成综述。使用方式：按技能给出的 CARE 清单逐项填写，用示意图命令生成患者临床进展时间线，再用 validate_case_report.py 查漏。实际体验：清单本身即是一份写作教案，从「不知道写什么」变为「逐项填空」；注意新颖性论证与文献对比必须自己完成，技能无法替代对领域现状的判断。

场景四：住院医师的日常病程与出院摘要

角色：病房医师。痛点：SOAP 记录耗时，出院摘要要求囊括出院用药、出院状况与随访计划，下班前赶工容易漏项。使用方式：口述式提供主观症状、生命体征与查体、评估与计划，技能按 S/O/A/P 输出，并要求在出院摘要中补齐待处理结果与患者教育要点。实际体验：效率提升明显，格式统一；注意文档必须由本人核对并签名，且应避免复制粘贴旧记录导致的信息过时。

6. 该技能能为用户带来的价值

结构化带来的效率提升：把「回忆规范—搭骨架—填内容—自查」压缩为「选类型—给要素—按清单核对」，省去反复翻查指南与拼装模板的时间，尤其在需要连续产出同类文档时优势明显。

合规门槛显著降低：18 项 HIPAA 标识符、ICH-GCP 要点、FDA 电子记录与知情同意相关要求都被拆解成可勾选条目，并配有 check_deidentification.py 等脚本自动扫描，让「合规」从抽象责任变成可见的检查结果，降低因去标识化不足或章节缺失被退稿、被质询的风险。

文档质量的一致性提升：模板与术语规则统一使用，能减少同类报告结构不统一、缩写不规范（如 QD、U、尾随零）等低级问题，对团队协作与多中心研究尤为有价值。

写作门槛下移：对医学生、低年资医师、非英语母语的作者，CARE 与 ICH-E3 结构本身就是最好的写作教材，技能把学习成本前置到「照着做」的流程中。

长期价值：当病例报告、诊断报告、试验文档、患者记录都走同一条规范化路径，机构层面的文档质量基准、培训素材与审计准备材料也会同步沉淀下来。需要强调的是，技能产出始终是草稿，专业判断、最终审签与合规责任仍由撰写者与所在机构承担。

7. 常见问题 FAQ

Q1：这个技能怎么安装？需要付费吗？ A：在 AI 技能市场或技能库中搜索英文名 clinical-reports 或技能ID 13098，进入详情页安装/启用；本地目录模式按官方文档放置技能文件。安装前提是运行环境支持 Read、Write、Edit、Bash。是否收费、具体安装命令与入口以官方说明为准。

Q2：生成的临床报告能直接投稿或提交监管机构吗？ A：不能直接提交。技能的定位是生成符合规范结构的初稿并做自动化校验，专业判断、结论措辞、伦理与知情同意、最终签名仍需撰写者与所在机构完成。建议把校验脚本的输出当作「待补清单」，逐项确认后再定稿。

Q3：它和直接用通用 AI 助手写有什么区别？ A：通用助手能写通顺文字，但不清楚 CARE 的章节构成、ICH-E3 的编号结构、SAE 的因果关系分级与报告时限，也没有模板与脚本。该技能把这些规范固化进流程，并提供 validate_case_report.py、check_deidentification.py 等工具做机器核查，一致性更好。

Q4：它支持中文写作吗？术语怎么办？ A：技能本身是方法论与模板体系，可服务于中文或英文临床文档的写作组织。医学术语与编码规范（SNOMED CT、LOINC、ICD-10-CM、CPT）以及缩写使用规则已在技能中给出，你可以指定输出语言，但涉及编码的具体取值仍需按所在机构与当地规范核实。

Q5：适合哪些人使用？哪些人不适合？ A：适合临床医师、住院医师、医学生、临床研究协调员、医学写作与医学事务人员，以及需要产出结构化诊断报告或试验文档的团队。如果只是偶尔写一段非正式说明，通用助手更轻量；如果所在机构已有深度集成的结构化报告系统，则可把本技能用于面向发表与监管提交的文档类型，作为院内系统的补充。