buck2-rule-basics

buck2-rule-basics 技能為希望精通 Buck2 建構系統的工程師提供了一個沈浸式、循序漸進的學習環境。該技能並非靜態文件，而是透過互動式工作流，引導您編寫並測試實際的 Buck2 規則來進行文字處理。它帶領您深入了解 Buck2 建構模型的複雜性，包括載入、配置、分析和執行階段。非常適合剛開始使用 Buck2 專案的開發人員，或是希望了解如何在高效能建構環境中定義自訂建構邏輯的工程師。

• 提供包含 8 個獨立模組的互動式引導，追蹤您的學習進度，從最小規則雛形到複雜的配置依賴建構。

• 整合技術參考資料，涵蓋核心概念，如構件 (artifacts)、提供者 (providers) 傳播、傳遞依賴項 (transitive dependencies) 以及複雜的動作定義。

• 涉及實際 buck2 命令列介面的動手練習，確保所學技能能立即應用於現實的軟體工程任務。

• 適應性的教學風格，為初學者提供額外的背景資訊，同時允許經驗豐富的用戶快速跳過已知概念，或直接嘗試進階模式。

• 請務必遵循教學特定的說明：開始時先檢查當前專案狀態，建立必要的檔案 (例如 uppercase.bzl, BUCK 檔案)，並在所有作業中使用系統的 buck2 二進位檔。

• 使用提供的 references/concepts.md 深入了解分析與建構圖結構 (uquery, cquery, aquery)，並使用 references/advanced_patterns.md 學習生產環境模式，例如自訂提供者與工具鏈依賴。

• 本教學強調做中學；請務必使用 buck2 build 命令驗證每個步驟，並觀察引擎如何管理動作與構件。

• 在進入如 select() 解析或多平台建構等複雜主題前，請務必透過技能提供的評估問題進行互動，以確保充分理解。