用途:该技能面向 Elements monorepo 的构建体系,帮助优化构建性能与并行化、理解 Wireit 任务依赖、排查构建失败或缓存问题、为项目新增构建任务、配置跨包构建编排,以及理解 CI/CD 构建流水线。修改构建配置或排查构建问题前,必须先查阅构建系统文档。
主要能力:Wireit 提供带缓存的构建编排(类似 Node 版 Bazel)。配置位于各项目 package.json 的 wireit 键下,每个任务声明 command(命令)、dependencies(需先完成的其它 Wireit 任务,可跨包)、files(用于缓存失效的输入 glob)、output(被缓存的输出 glob)。输入未变化时 Wireit 会跳过任务;需强制重建时删除项目目录下的 .wireit/。跨包依赖使用 <package>:<script> 格式。
常用命令: 本地跑完整 CI(lint、build、test):pnpm run ci 清理全部(node_modules、dist、.wireit 缓存):pnpm run ci:reset 构建单个项目:cd projects/core && pnpm run build 带 watch 的开发模式:cd projects/core && pnpm run dev 完全重置:pnpm run ci:reset && pnpm i --frozen-lockfile && pnpm run ci
故障排查:缓存陈旧导致输出错误时,删除受影响项目的 .wireit/ 后重建;包变更后出现 Cannot find module,运行 pnpm i --frozen-lockfile 重新链接工作区;依赖更新后出现 TypeScript 错误,先重建依赖(如 cd projects/themes && pnpm run build);本地通过但流水线失败,检查 Node 版本(node -v 应与 .nvmrc 一致)和 pnpm 版本。
新增任务:把脚本加入 package.json 并配置 wireit,声明 files 与 output 以支持缓存,添加需先构建的上游包依赖;若需在 CI 运行,将其加入根 ci 脚本的依赖链。
关键工具:pnpm(带工作区的包管理器)、Wireit(带缓存的构建编排)、Vite(TypeScript 编译与打包)、Semantic Release(基于约定提交自动版本化)。
限制:资料未提供具体版本要求、性能指标或排错之外的更多细节。