用於輕量專案計劃的 Mermaid 甘特圖

當專案計劃需要和實作說明放在同一個倉庫裡時，Mermaid 甘特圖就很有用。文字原始碼可審閱、可版本化，因此適合發佈計劃、遷移計劃和規模不大的文件專案。

明確日期和任務 ID

gantt
  title Documentation release
  dateFormat YYYY-MM-DD
  axisFormat %b %d

  section Research
  Audit existing pages :done, audit, 2026-07-11, 3d
  Select topics        :topics, after audit, 2d

  section Delivery
  Draft guides         :active, draft, after topics, 6d
  Technical review     :review, after draft, 2d
  Publish              :milestone, publish, after review, 0d

像 audit 和 draft 這樣的任務 ID 可以穩定地作為依賴目標。人類可讀的任務名稱可以改，而不會破壞 after 引用。在使用字面日期之前，先設定 dateFormat，這樣讀者和渲染器都能用同一種方式理解。

狀態標記要少用

done、active、crit 和 milestone 這些標記可以強調狀態，但如果每個任務都標成 critical，訊號就失效了。里程碑沒有持續時間，它表示決策點或交付點，而不是持續數天的工作。

把依賴關係當成溝通

after draft 表示圖中的完成到開始依賴。真實排期可能還需要資源容量、並行工作比例、工作日曆和部分完成度。Mermaid 不是完整的專案管理系統，所以不要讓圖表暗示它沒有的精度。

如果週末和假日會影響承諾，需要確認渲染環境是否支援排除日曆，並在圖旁邊寫清楚假設。對於合約級排程，應該以正式的計劃系統為準，再附上一張簡化的 Mermaid 視圖。

讓計劃保持可審閱

把相關任務分組到不同 section，並保持標籤簡短。更新日期時，應該和實際承諾一起放進同一個 Pull Request。一個好看但日期過期的甘特圖，不如一份樸素但最新的清單。

當圖表超過一螢幕時，最好拆成路線圖和詳細計劃。路線圖展示階段和里程碑，詳細計劃展示目前階段的任務依賴。

在 本地 Mermaid 編輯器 中打開 Gantt 模板，驗證原始碼後再匯出為 SVG 或 PNG。