bpmn

bpmn skill 概覽

bpmn skill 能幫你在 PlantUML 裡使用 BPMN、EIP 與 Lean Mapping 的模板圖示，建立業務流程與整合流程圖。當你需要一張能清楚說明工作流程自動化、審核、協調、訊息傳遞或 ETL 邏輯，讓團隊能直接採取行動的圖時，它特別適合。

當你的真正需求，是把一個粗略的流程想法，轉成一張結構完整、gateway、event、task 與 pool/lane 都選對的圖時，就該用 bpmn skill。若你要的是一般軟體架構圖，或本質上是資料視覺化的圖表，這個 skill 就沒那麼適合。

bpmn 最適合的使用情境

• 工作流程自動化：審核、升級處理、交接、重試與 SLA 路徑
• 以訊息為主的整合：router、channel、translator、adapter 與 dead-letter 處理
• 營運流程：訂單處理、客服分流、saga 協調、ETL 與 value stream

bpmn skill 為什麼不一樣

這個 repo 的重點是模板規範，而不是自由發揮式繪圖。也就是說，當你需要的是 BPMN 專用元件，例如 start/end event、message flow、gateway 與 lane，而不是單純方塊和箭頭時，它的輸出通常會更好。bpmn skill 也更容易幫你判斷：這個問題該用 process、integration，還是 value stream 的視覺語言來表達。

什麼情況下不該用它

如果你要的是 class diagram、component diagram，或一般軟體模型，請改用 uml。如果你要的是 dashboard、chart 或資料視覺化，請改用 vega。這些情境若硬套 bpmn，通常會比直接用對應 skill 得到更差的結果。

如何使用 bpmn skill

安裝並開啟 skill 檔案

用以下指令安裝 bpmn skill：

npx skills add markdown-viewer/skills --skill bpmn

接著先開啟 SKILL.md，再看符合你流程類型的範例檔。範例是最快理解這個 repo 的標記選擇方式、並避免 PlantUML 格式出錯的方法。

為 bpmn 準備好用的提示詞

一個好的 bpmn 提示詞應該包含：

• 流程名稱
• 觸發條件或起始事件
• 主要角色或 pools
• 關鍵決策與例外情況
• 這是偏 BPMN、EIP 還是 Lean Mapping
• 任何 SLA、重試或補償行為

提示詞範例：

“Create a bpmn skill diagram for an invoice approval workflow. Start with invoice submission, route small invoices to auto-approval, medium invoices to manager review, and large invoices to manager plus finance. Include an SLA timer, escalation path, and rejection end state.”

這樣模型就有足夠結構去選對模板家族與流程邏輯。

先讀這些檔案

先從以下檔案開始：

• SKILL.md：核心規則與 fence 要求
• examples/approval-workflow.md：偏決策型的 BPMN
• examples/microservice-orchestration.md：saga 式協調
• examples/eip-messaging.md：整合模式圖
• examples/etl-pipeline.md：批次與資料搬運流程

這些檔案是最有用的 bpmn 指南，因為它們直接示範不同模板家族各自對應哪些使用情境。

能明顯提升輸出的實用技巧

• 只使用 ```plantuml 或 ```puml fence。
• 圖一定要包在 @startuml / @enduml 之間。
• 對於從開始到結束閱讀的流程，優先用 left to right direction。
• 如果責任歸屬很重要，盡早指定 pools/lanes。
• 說清楚流程是 sequence flows 還是 message flows。
• 決策點請用問句命名，不要只寫標籤。

例如，Payment OK? 會比 Payment status 更具行動性。

bpmn skill 常見問答

bpmn 只適合流程圖嗎？

不是。bpmn skill 同時涵蓋 BPMN 流程、EIP 整合模式，以及 Lean Mapping 符號。因此它不只適合工作流程自動化與服務協調，也適合營運型 value-stream 圖，以及傳統的審核流程。

用 bpmn 之前一定要懂 BPMN 嗎？

不一定，但懂一點基本流程語言會有幫助。只要你能描述誰先開始工作、有哪些決策點，以及工作可能在哪裡失敗或暫停，這個 skill 通常就能把它轉成有用的圖。

bpmn 跟一般提示詞比起來好在哪裡？

一般提示詞可能只會產出普通的方塊與箭頭。bpmn skill 會把輸出偏向正確的模板家族、PlantUML 格式，以及工作流程專用慣例，因而減少後續整理成本，也讓圖在 workflow automation 的情境下更容易閱讀。

什麼時候該選別的 skill？

如果主要目標是軟體結構、UI mockup、分析圖表或資料視覺化，就該選別的 skill。bpmn skill 最強的是回答「工作怎麼流動？」而不是「系統裡有哪些內容？」。

如何改善 bpmn skill

提供流程狀態，不只是主題

最好的 bpmn 結果，來自能描述實際 workflow 狀態機的輸入。請包含開始、分支、例外、完成與交接邊界。例如：

• 較弱：Make an order diagram
• 較強：Order starts after checkout, validates payment, checks inventory in parallel, sends shipment and notification after reserve, and routes failures to cancel or backorder paths

多給這些細節，會同時改善結構與模板選擇。

告訴 skill 什麼最重要

如果你的優先目標是審核政策，就直接說。如果你最在意整合可靠性，也要明講。如果你重視吞吐量或交接清晰度，也請說明。bpmn skill 可以強調流程的不同面向，但前提是你有明確指出判斷準則。

注意常見失敗模式

最常見的問題，是 gateway 文字太模糊、缺少 lane 的責任歸屬，以及把 message flow 和 sequence flow 混在一起。另一個常見問題，是為了好看塞進太多裝飾性步驟。請只保留會改變路由、責任或系統行為的步驟。

用有針對性的修正方式迭代

第一次輸出後，下一版最好一次只修正一件事：

• Add a timer escalation after 48 hours
• Split human tasks into manager and finance lanes
• Replace generic task boxes with EIP message translator and router icons
• Show compensation steps for payment failure

這種做法通常比要求整份重寫更有效，也能讓 bpmn skill 持續聚焦在真正卡住你的 workflow automation 設計上。