一份实用的针灸 SOAP 病历同时完成两项任务：建立清晰临床记录，并让未来阅读者理解专业人士的推理。最好的病历简洁，却不会抹去从发现到证型、治则与配穴处方的路径。
供持证专业人士教育参考。本文并非针对具体患者的医疗建议，也不建议诊断或治疗。
先明确病历的用途
SOAP 病历不是逐字记录，而是患者陈述、专业人士观察、发现评估及计划或已执行内容的结构化记录。针灸病历还可能需要以适合美国文书环境的语言保留中医推理。
良好文书会区分观察与解释。“患者报告睡眠中断三次”属于主观资料；脉象或舌象观察属于客观资料；拟定证型属于评估；治则与所选穴位属于计划。保持这些类别清楚，能让病历更易审核，并避免暗示证据并不支持的确定性。
主观资料：记录临床故事，而非每一句话
主观资料应记录主要诉求、相关病史、症状特征、与上次就诊相比的变化，以及患者对反应的描述。有用的具体信息包括部位、性质、时间、加重或缓解因素与功能影响。
为支持中医推理，专业人士也可记录相关睡眠、食欲、口渴、寒热偏好、二便、精力、情绪背景或其他系统回顾资料。目标不是纳入所有可能问题，而是保留与评估相关并有助于连续照护的细节。
客观资料：让观察可以复核
客观文书可包括可观察发现、适当测量、触诊、活动范围，以及相关时的脉象和舌象。不要把推断写成直接观察。例如，应先描述舌质与舌苔，再在评估中把这些观察作为证型依据。
一致性有助于比较。可重复使用的脉舌词汇便于纵向观察，但模板不应强迫记录未评估的发现。未经审核沿用空白字段或默认正常描述，可能形成误导病历。
评估：把发现连接到辨证
评估应呈现专业人士的综合判断。针灸病历可在适当时包括生物医学或功能评估、中医辨证，以及支持该判断的简要发现。若情况混合，应记录不确定性或竞争证型，而不是强行套用单一标签。
一句紧凑的推理说明往往比长篇理论更有用：指出拟定证型、关键支持发现，并在存在时注明重要不一致。这能帮助后来的阅读者理解治则为何如此制定。
计划：把治则连接到配穴
计划应写明治则、所选穴位、相关手法细节、记录时的患者反应与随访安排。当穴位清单与临床意图相连时，它才更有意义。阅读者应能追溯从发现到证型、从证型到治则、再从治则到配穴处方的路径。
记录实际发生的内容，而不仅是模板建议。若重新评估后删除、替换或加入穴位，最终病历应反映专业人士批准的计划。
人工智能可以协助到哪里，又应在哪里停止
文书助手可以整理问诊资料、识别缺失字段并草拟简明结构，也可以提出候选依据供审核。它不应虚构发现、定稿证型，或在没有持证专业人士参与时选择临床计划。
最安全的流程应清楚可见且可编辑：系统把输出标为草稿，区分来源事实与生成综合，并允许专业人士确认或拒绝每个重要步骤。ASKLEMER 正围绕这条专业人士全程参与的边界进行设计。
核心结论
临床人工智能只有在清楚区分事实、推断、来源与专业人士决定时最有价值。ASKLEMER 仍在开发中，不声称具有临床表现或当前可用性。