SuperAPI AI 工具集

bazel

写作与研究

查看项目

更新于 10-15 20:11

技能介绍

用途:围绕实际目标图和固定的 Bazel/ruleset 版本进行构建变更与故障排查,示例基于 Bazel 9.2.0,但不构成升级指令;用户明确指令优先于本技能指南。

主要能力:先建立相关上下文,以受影响目标、错误输出或期望构建结果为输入,检查 .bazelversion、相关模块声明、BUILD 文件及任务涉及的配置,仅在影响问题时读取其他仓库配置。按问题选择工具:目标依赖、反向依赖与路径用 bazel query;选定标志、平台、工具链或 select() 分支用 bazel cquery 并带上失败调用的配置;实际命令、输入、输出与工具用 bazel aquery;外部模块、版本与生成仓库用 bazel mod;缓存未命中或执行性能看执行日志、profile、BEP。若无法推断失败目标或调用,应询问并继续独立检查,不得编造仓库固定版本或远程缓存端点。

使用方式:保持构建契约,在所属目标上声明直接输入、依赖、工具与运行时数据,运行时资源使用 runfiles API;包边界与可见性要有意设计,不套用“每文件一目标”或“每服务一目标”的通用模板。Bazel 9 使用 Bzlmod 和显式外部语言规则加载;旧仓库遵循版本匹配规则,直到被要求升级。先诊断缺失输入或配置差异,再考虑 clean --expunge 或禁用沙箱,后者可能掩盖原因。验证受影响目标与配置,仅在影响全图或仓库必需检查时才做全图构建/测试。交付所需补丁或诊断,附相关目标标签、证据和未解决的配置依赖,完成该结果所需检查,不把局部修复扩大为仓库迁移。

参考:按需加载主题,长参考用章节标题定位。BUILD-GRAPH.md 涵盖包、标签、依赖、可见性与 BUILD 风格;BZLMOD.md 涵盖模块、扩展、锁文件、覆盖与 WORKSPACE 迁移;CONFIGURATION.md 涵盖 rc 文件、selects、平台、工具链与转换;QUERIES-DEBUGGING.md 涵盖查询语法与构建失败诊断;HERMETICITY-CACHING.md 涵盖沙箱、runfiles、缓存与远程执行;CI-PERFORMANCE.md 涵盖 CI 门禁、受影响目标、profile 与性能;STARLARK.md 涵盖宏、规则、provider、aspect 与仓库规则;ADOPTION.md 涵盖采用或仓库整合;CHEATSHEET.md 用于紧凑命令或标签查询。当内置指南无法确定兼容性时,使用版本匹配的 Bazel 文档、ruleset 发布说明和 Bazel Central Registry。

限制:资料未提供具体安装命令、收费或价格信息;示例版本不代表升级建议。