一份實用的針灸 SOAP 病歷同時完成兩項任務：建立清晰臨床記錄，並讓未來閱讀者理解專業人士的推理。最好的病歷簡潔，卻不會抹去從發現到證型、治則與配穴處方的路徑。
供註冊及合資格專業人士教育參考。本文並非針對具體患者的醫療建議，也不建議診斷或治療。
先明確病歷的用途
SOAP 病歷不是逐字記錄，而是患者陳述、專業人士觀察、發現評估及計劃或已執行內容的結構化記錄。針灸病歷還可能需要以適合美國文書環境的語言保留中醫推理。
良好文書會區分觀察與解釋。“患者報告睡眠中斷三次”屬於主觀資料；脈象或舌象觀察屬於客觀資料；擬定證型屬於評估；治則與所選穴位屬於計劃。保持這些類別清楚，能讓病歷更易審核，並避免暗示證據並不支持的確定性。
主觀資料：記錄臨床故事，而非每一句話
主觀資料應記錄主要訴求、相關病史、症狀特徵、與上次就診相比的變化，以及患者對反應的描述。有用的具體資訊包括部位、性質、時間、加重或緩解因素與功能影響。
為支持中醫推理，專業人士也可記錄相關睡眠、食慾、口渴、寒熱偏好、二便、精力、情緒背景或其他系統回顧資料。目標不是納入所有可能問題，而是保留與評估相關並有助於連續照護的細節。
客觀資料：讓觀察可以復核
客觀文書可包括可觀察發現、適當測量、觸診、活動範圍，以及相關時的脈象和舌象。不要把推斷寫成直接觀察。例如，應先描述舌質與舌苔，再在評估中把這些觀察作為證型依據。
一致性有助於比較。可重復使用的脈舌詞彙便於縱向觀察，但模板不應強迫記錄未評估的發現。未經審核沿用空白字段或默認正常描述，可能形成誤導病歷。
評估：把發現連接到辨證
評估應呈現專業人士的綜合判斷。針灸病歷可在適當時包括生物醫學或功能評估、中醫辨證，以及支持該判斷的簡要發現。若情況混合，應記錄不確定性或競爭證型，而不是強行套用單一標籤。
一句緊湊的推理說明往往比長篇理論更有用：指出擬定證型、關鍵支持發現，並在存在時注明重要不一致。這能幫助後來的閱讀者理解治則為何如此制定。
計劃：把治則連接到配穴
計劃應寫明治則、所選穴位、相關手法細節、記錄時的患者反應與隨訪安排。當穴位清單與臨床意圖相連時，它才更有意義。閱讀者應能追溯從發現到證型、從證型到治則、再從治則到配穴處方的路徑。
記錄實際發生的內容，而不僅是模板建議。若重新評估後刪除、替換或加入穴位，最終病歷應反映專業人士批准的計劃。
人工智能可以協助到哪裡，又應在哪裡停止
文書助手可以整理問診資料、識別缺失字段並草擬簡明結構，也可以提出候選依據供審核。它不應虛構發現、定稿證型，或在沒有註冊及合資格專業人士參與時選擇臨床計劃。
最安全的流程應清楚可見且可編輯：系統把輸出標為草稿，區分來源事實與生成綜合，並允許專業人士確認或拒絕每個重要步驟。ASKLEMER 正圍繞這條專業人士全程參與的邊界進行設計。
核心結論
臨床人工智能只有在清楚區分事實、推斷、來源與專業人士決定時最有價值。ASKLEMER 仍在開發中，不聲稱具有臨床表現或當前可用性。