用途:这是一个交互式、分步式教程技能,通过动手实践讲解 Buck2 构建系统基础。用户将编写一个把文本转为大写的简单文本处理规则,在过程中理解核心概念。
主要能力:教程分 8 步递进——创建最小规则桩(返回空 DefaultInfo)、添加源文件属性、声明输出产物、创建动作、理解目标(未配置与已配置)、用 select() 添加配置支持、添加依赖、区分规则与宏。技能还包含参考文档 references/concepts.md(构建模型、目标、产物、动作、Provider、配置、分析阶段、构建图与查询)和 references/advanced_patterns.md(自定义 Provider、传递依赖、工具链、多输出、命令行构建、配置相关规则、测试规则)。
使用方式:技能启动时先检查已有教程文件与进度,询问用户从头开始还是继续。每次只讲一步:介绍概念、实现代码、一起测试、解释结果、汇总文件变更,然后用苏格拉底式提问让用户用自己的话回答,确认理解后再继续。使用系统 buck2 命令(如 buck2 build、buck2 test、buck2 cquery),不使用 ./buck2.py。
适用场景:希望学习 Buck2 规则编写、构建阶段与配置机制的开发者。
限制:教程内容与参考文档以资料所述为准;具体平台、版本或环境要求暂未提供。