工程開發
release-crate avatar

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
在 GitHub 查看