dart-package-maintenance

此技能提供了一套符合 Dart 社群最佳實踐的套件維護系統化方法。適用於套件維護者與管理協作儲存庫的軟體工程師，旨在確保版本控制的一致性、發佈歷史的透明度以及發佈週期的可靠性。透過遵循這些指南，開發人員可以減少下游中斷，並為終端使用者提供清晰且具影響力的發佈說明。

• 語意化版本控制 (SemVer) 的應用：根據重大變更、功能新增或錯誤修復正確應用主版本、次版本與修補版本號。

• 自動化一致性檢查：確保 pubspec.yaml 中的版本欄位與 CHANGELOG.md 的標題保持同步。

• 發佈工作流程管理：處理進行中 (WIP) 版本、Git 標籤發佈以及準備 pub.dev 發佈套件的最佳實踐。

• Pull Request 與程式碼審查標準：維持乾淨提交紀錄的指導、處理合併衝突的建議，以及有效的 PR 溝通技巧。

• 以使用者為中心的文檔記錄：篩選變更日誌內容的策略，強調使用者可見的影響，而非內部重構或僅針對測試的變更。

• 當準備發佈新版本或在共享儲存庫中合併重大變更時，請使用此技能。

• 在修改版本元數據之前，務必透過 Git 或 pub.dev 驗證目前的發佈標籤，以避免版本衝突。

• 變更日誌應保持清晰溝通；省略不影響公開 API 的內部變更。

• 在處理 PR 衝突時，建議將 main 分支合併至功能分支，以保留審查歷史背景與評論。

• 發佈後請立即在版本字串中加上 -wip 後綴，以標示套件目前處於開發狀態。