bazel-build-optimization

總覽

什麼是 bazel-build-optimization？

bazel-build-optimization 是一項專門技能，旨在協助開發者與團隊優化大型單一倉庫中的 Bazel 建置。它提供實用指引，涵蓋 Bazel 配置、遠端快取與執行的實作，以及提升企業環境中的建置效能。此技能對於正遷移至 Bazel 或在複雜代碼庫中遇到建置緩慢問題的組織特別有用。

誰適合使用此技能？

• 管理 Bazel 單一倉庫的開發者
• 尋求加快建置速度的建置工程師
• 從其他建置系統遷移到 Bazel 的團隊
• 需要配置自訂 Bazel 規則或除錯建置問題的任何人

解決的問題

• 大型倉庫建置速度緩慢
• 建置配置效率低落
• 遠端快取與執行設定困難
• 撰寫自訂 Bazel 規則的挑戰

使用說明

安裝步驟

1. 使用以下指令安裝技能：
   npx skills add https://github.com/wshobson/agents --skill bazel-build-optimization
2. 閱讀 SKILL.md 檔案，了解總覽與工作流程指引。
3. 探索支援檔案，如 README.md、AGENTS.md、metadata.json，以及 rules/、resources/、references/、scripts/ 等資料夾，取得更多背景資訊與範本。

初始設定

• 從配置 Bazel 工作區開始，使用 WORKSPACE.bazel、.bazelrc、.bazelversion、BUILD.bazel 等檔案。
• 利用提供的範本與範例設定遠端快取與執行。
• 根據你的倉庫結構與建置需求調整推薦模式。

最佳實踐

• 利用 Bazel 的遠端快取加速團隊間建置。
• 撰寫自訂規則以滿足專案特定建置需求。
• 定期檢視建置配置，找出效能瓶頸。

適用時機

• 你的代碼庫為單一倉庫或具有複雜依賴關係。
• 你需要優化 CI/CD 管線的建置時間。
• 你正在遷移至 Bazel，並希望採用經驗證的模式。

不適用時機

• 你的專案規模較小，不需要 Bazel。
• 你不需要進階建置優化或遠端執行功能。

常見問題

我在哪裡可以找到範本與範例？

工作區配置與建置檔案的範本可在技能的支援資料夾與 SKILL.md 中找到。

如何除錯 Bazel 建置問題？

此技能提供除錯建置問題的指引，包括檢查建置目標、規則與遠端執行日誌的技巧。

我可以在非單一倉庫專案中使用此技能嗎？

雖然此技能針對單一倉庫優化，但部分模式可調整應用於較小專案，主要效益仍體現在大型倉庫中。

如何取得所有資源？

開啟 Files 標籤即可查看完整檔案樹，包括巢狀的參考資料、範本與 Bazel 建置優化的輔助腳本。