Clarify Flow Description

目的

將模糊、口語化或結構鬆散的流程說明，重寫為精確、結構化、可直接對應 Mermaid 流程圖節點的格式，確保每個步驟、判斷、分支都清晰可追蹤。

適用情境

• 從會議紀錄或需求訪談中整理出的粗略流程說明
• 口語化描述的業務邏輯，需轉為正式規格
• 準備繪製 Mermaid 流程圖前的前置整理
• 流程說明需要讓非原作者也能看懂

優化原則

1. 結構化分區

每個流程必須包含以下區塊：

區塊	說明	對應 Mermaid 元素
比對條件	列出該流程用來匹配資料的關鍵欄位	流程起始節點的輸入條件
處理流程	以編號步驟描述完整邏輯	流程圖中的處理節點與判斷菱形

2. 步驟撰寫規範

每個編號步驟應遵循以下原則：

原則	說明	範例
明確資料來源	說明從哪張表或哪個服務取得資料	「查詢 InsertAlert 資料表中…」
列舉篩選條件	逐一列出 include / exclude 條件	「排除 SendDeadline 小於當前主機時間的資料」
Null 值處理	明確說明 NULL 或空值時的行為	「SendDeadline 為 NULL 時，視為無截止時間限制，不排除」
排序規則	指定排序欄位與方向	「符合條件的資料依 pk Id 由小到大排序」
欄位名稱反引號	欄位名稱使用反引號標記	MainCategory、SubCategory

3. 判斷分支撰寫規範

遇到 if / else 邏輯時：

原則	說明	範例
粗體標記分支	用粗體標示每個分支的條件	Key 存在時（快取期間內）：
縮排呈現層級	子分支用縮排或清單表示	- **未過期：** 將該筆資料加入待發送清單
明確結束點	說明何時結束遍歷或跳出流程	「結束遍歷」、「繼續往下遍歷下一筆資料」
無符合結果	說明全部不符合時的行為	「遍歷完該批次所有資料，本次無符合條件資料」

4. 迴圈/遍歷撰寫規範

原則	說明
明確遍歷對象	說明遍歷的資料集合是什麼
迴圈內判斷	每次迭代要檢查什麼條件
提前退出	滿足什麼條件時結束遍歷
遍歷完畢	全部遍歷完無符合時的處理

優化前後對照範例

參考 references/repeat.md，以一份高複雜度的範例展示所有優化原則的實際應用（涵蓋：步驟串接、多層分支、迴圈遍歷、外部服務互動）。

輸出規範

1. 保留原始語意：不改變業務邏輯，只改善表達方式
2. 一個流程一個區塊：每種策略或流程獨立一個小節，包含比對條件與處理流程
3. 步驟連貫可追蹤：步驟之間可用「承接第 N 點」串接，確保讀者能追蹤上下文
4. 可直接對應 Mermaid：每個步驟對應一個處理節點，每個判斷對應一個菱形節點，每個分支對應一條連線
5. 輸出後更新指定文檔：將優化後的流程說明寫回用戶指定的檔案路徑