
為什麼圖示很重要
- 想理解程式碼庫裡的流程控制
- 需要追蹤資料血統,從輸入一路到輸出
- 要帶新人上手或替系統寫文件
需要考量的兩個面向
- 目的:你是在描繪邏輯、資料流程、基礎設施,還是其他?
- 格式:你想要快速上手的(例如 Mermaid 圖)還是比較正式的(例如 UML)?
要怎麼下指令
- 流程: 「告訴我請求是怎麼從 controller 走到資料庫的。」
- 資料沿革: 「把這個變數從進來到最後落點的整條路徑追出來。」
- 結構: 「給我這個 service 的元件層級視圖。」
使用 Mermaid
flowchart
:用於邏輯與流程sequenceDiagram
:用於互動序列classDiagram
:用於物件結構graph TD
:用於簡單的有向圖
- 前往「Extensions」分頁
- 搜尋「Mermaid」
- 點擊安裝

圖表策略
- 選一個函式、路由或流程
- 請 Cursor 用 Mermaid 把那一部分畫成圖
- 有了幾個之後,再請它把它們合併
建議流程
- 先從細節充足的低層級圖開始
- 把它摘要成中層視圖
- 重複以上步驟,直到達到想要的抽象層級
- 請 Cursor 把它們合併成單一圖或系統地圖
重點
- 用圖表理解流程、邏輯和資料
- 從小型提示開始,逐步擴充你的圖表
- Mermaid 是在 Cursor 中最好用的格式
- 先從低階細節著手,再向上抽象,就像 C4 模型一樣
- Cursor 能輕鬆幫你生成、優化並組合圖表