clinical-notes¶

Skill 简介¶

Clinical Notes 是一个基于 OpenClaw 平台的智能技能，旨在将临床诊疗过程中的自由文本叙述转换为结构化的 SOAP（Subjective, Objective, Assessment, Plan）格式文档。SOAP 格式是一种广泛应用于医疗领域的标准记录方法，能够帮助医疗从业者系统化地记录患者信息、诊断和治疗计划。然而，手动编写 SOAP 笔记不仅耗时，还容易出现格式不一致或信息遗漏的问题。Clinical Notes 通过自动化处理，将非结构化的临床叙述转化为符合规范的 SOAP 文档，并提供 ICD-10 编码建议、完整性检查以及文档缺失分析等功能，极大地提升了医疗文档编写的效率和准确性。

该技能不仅适用于日常的临床记录，还能帮助医疗机构更好地管理电子健康记录（EHR）系统。通过自动化的文档生成和检查机制，Clinical Notes 能够有效减少人为错误，确保医疗记录的完整性和一致性，从而提升整体医疗服务质量。

主要功能¶

1. 结构化 SOAP 笔记生成
Clinical Notes 能够将自由文本的临床叙述自动转换为结构化的 SOAP 格式文档。它能够识别并提取主观描述（Subjective）、客观数据（Objective）、评估（Assessment）和治疗计划（Plan）等关键信息，并按照标准格式进行组织。

2. ICD-10 编码建议
在生成 SOAP 笔记的同时，Clinical Notes 会根据临床叙述内容提供相应的 ICD-10 编码建议。这不仅有助于标准化诊断分类，还能提高医疗报销和保险处理的效率。

3. 完整性检查
该技能能够对生成的 SOAP 笔记进行完整性检查，识别并标记可能缺失的重要信息。例如，如果某个患者的病史记录不完整，Clinical Notes 会提示用户补充相关信息。

4. 文档一致性维护
Clinical Notes 确保所有生成的 SOAP 笔记遵循统一的格式和术语标准。这对于需要长期跟踪和管理患者信息的 EHR 系统尤为重要。

5. 批量处理能力
用户可以一次性提交多个临床叙述，Clinical Notes 会自动生成相应的 SOAP 笔记，并进行批量处理。这对于处理大量患者记录或进行回顾性分析非常有用。

6. 文档缺失分析
除了完整性检查，Clinical Notes 还能对现有文档进行缺失分析，并提供改进建议。例如，它会提示用户补充必要的检查结果或治疗计划细节。

使用场景¶

1. 日常临床记录
医疗从业者在日常诊疗过程中，可以使用 Clinical Notes 将患者的就诊叙述快速转换为结构化的 SOAP 笔记，从而节省时间并减少错误。

2. EHR 系统集成
医疗机构可以将 Clinical Notes 集成到其 EHR 系统中，实现自动化文档生成和管理，确保所有患者记录的一致性和完整性。

3. 医疗研究和数据分析
研究人员可以利用 Clinical Notes 对大量临床数据进行批量处理和标准化，从而更方便地进行数据分析和研究。

4. 医疗培训和教育
医学院校和培训机构可以使用 Clinical Notes 作为教学工具，帮助学生学习和掌握 SOAP 笔记的编写规范。

5. 医疗质量管理
医疗机构可以利用 Clinical Notes 对现有文档进行缺失分析，并进行质量改进，从而提升整体医疗服务质量。

如何使用¶

安装与配置¶

首先，确保你已经安装了 OpenClaw 平台。然后，按照以下步骤安装 Clinical Notes：

mkdir -p ~/.openclaw/agents/clinical-notes/agent
cp SOUL.md ~/.openclaw/agents/clinical-notes/agent/
openclaw agents add clinical-notes --workspace ~/.openclaw/agents/clinical-notes

前置条件¶

OpenClaw 平台已安装并配置完毕
具备基本的命令行操作知识
具备对 SOAP 笔记格式的基本了解

示例¶

示例 1：生成单个 SOAP 笔记¶

假设你有一个患者的就诊叙述如下：

"45yo male, lower back pain 2 weeks, no prior history of back issues, normal physical exam, MRI scheduled."

使用 Clinical Notes 生成 SOAP 笔记的命令如下：

echo "45yo male, lower back pain 2 weeks, no prior history of back issues, normal physical exam, MRI scheduled." | openclaw agents run clinical-notes

输出结果¶

{
  "subjective": "45-year-old male with lower back pain for 2 weeks. No prior history of back issues.",
  "objective": "Normal physical exam. MRI scheduled.",
  "assessment": "Lower back pain, likely musculoskeletal in nature.",
  "plan": "Continue monitoring. MRI to rule out underlying issues."
}

示例 2：批量处理多个临床叙述¶

假设你有多个临床叙述需要处理，可以将它们保存到一个文本文件中，然后使用以下命令进行批量处理：

openclaw agents run clinical-notes --input-file clinical-narratives.txt --output-file soap-notes.json

总结¶

Clinical Notes 是一个功能强大的工具，能够显著提升医疗文档编写的效率和准确性。它通过自动化生成结构化的 SOAP 笔记、提供 ICD-10 编码建议、进行完整性检查和文档缺失分析等功能，帮助医疗从业者更好地管理患者信息和提升医疗服务质量。无论是日常临床记录、EHR 系统集成，还是医疗研究和培训，Clinical Notes 都能发挥重要作用。对于希望提升医疗文档管理水平的开发者来说，Clinical Notes 是一个不可或缺的工具。

clinical-notes