release-crate
自動化 R3BL 工作區套件的完整發布流程,包含版本號更新、變更日誌維護、測試驗證以及發布至 crates.io。
簡介
release-crate 技能為 r3bl-open-core monorepo 內的 Rust 套件管理提供了一套標準化且自動化的流程。此工具專為維護者與資深開發者設計,旨在排除發布 cmdr 或 tui 等套件時的人為錯誤與手動繁瑣工作。透過強制執行嚴謹的操作順序,確保每次發布皆符合儲存庫內部的品質標準與文檔要求。
此技能引導使用者識別目標套件、更新 Cargo.toml 中的版本號,以及維護附帶目錄更新的 CHANGELOG.md 文件。它與儲存庫的測試基礎設施緊密結合,在執行任何發布動作前會進行完整的驗證檢查。透過最後階段的 Git 標記與 GitHub 發布建立,為每次發布事件提供了統一的稽核記錄。
-
自動化工作區套件的版本管理,支援二進位程式與函式庫結構。
-
整合本地檢查腳本(如 check.fish),確保在繼續之前通過建置、測試、文檔、Clippy 與格式化驗證。
-
自動化變更日誌格式化,包含版本條目與目錄更新。
-
支援 crates.io 的預演發布(dry-run),在正式推送前驗證元數據與打包配置。
-
處理 Git 標記並利用自定義模板產生結構化的 GitHub 發布說明。
-
內建安全機制,在執行不可逆的發布操作前強制要求使用者確認。
-
在啟用前,請確保所有代碼變更已提交且本地環境清潔。
-
此技能需要套件目錄名稱作為參數;系統會自動偵測是否為函式庫或二進位程式,以決定發布後是否需要執行 cargo install。
-
開始流程前,請務必確認 Cargo.toml 中的當前版本。
-
在預演階段請使用 --no-verify 標記,以繞過特定自定義構建配置可能引發的鏈接器問題。
-
若工作區環境有所變動,請隨時參考 docs/release-guide.md 以獲取最新的標準發布程序。
倉庫統計
- Star 數
- 470
- Fork 數
- 30
- Open Issue 數
- 57
- 主要語言
- Rust
- 預設分支
- main
- 同步狀態
- 閒置
- 最近同步時間
- 2026年5月1日 上午07:36