SuperAPI AI 工具集

guidance-build

通用与其它

查看项目

更新于 10-16 14:37

技能介绍

用途:面向 Elements 单体仓库的构建编排与排障,涉及 Wireit 任务依赖、构建性能优化与并行化、缓存策略、新增构建任务以及 CI/CD 构建管线理解。修改构建配置或排查构建问题前应先查阅构建系统文档。

主要能力:Wireit 配置位于各项目 package.json 的 wireit 键下,每个任务声明 command(执行的 shell 命令)、dependencies(须先完成的其他 Wireit 任务,可跨包)、files(用于缓存失效的输入文件 glob)与 output(被缓存的输出文件 glob)。跨包依赖使用 <package>:<script> 格式。输入未变化时 Wireit 会跳过任务;WIREIT_CACHE=none 仅关闭输出缓存,不会绕过这种增量新鲜度检查,强制重跑需在目标项目目录执行 mise exec -- git clean -dfX -- .wireit 后再调用项目脚本。

常用命令:完整本地 CI(lint、build、test)用 pnpm run ci;清理全部(node_modules、dist、.wireit 缓存)用 pnpm run ci:reset;构建单个项目进入 projects/core 后 pnpm run build;带 watch 的开发模式进入 projects/core 后 pnpm run dev;工作区重新链接用 pnpm i --frozen-lockfile。新增任务需加入 package.json 的 wireit 配置、声明 files 与 output、添加上游包依赖,若要进入 CI 还需加入根 ci 脚本的依赖链。

关键工具:pnpm(带工作区的包管理器)、Wireit(带缓存的构建编排)、Vite(TypeScript 编译与打包)、Semantic Release(基于约定式提交的自动版本管理)。

故障排查提示:缓存过期导致输出错误时清理受影响项目的 .wireit/ 后重建;包变更后出现 Cannot find module 时重跑 pnpm i --frozen-lockfile;依赖更新后出现 TypeScript 错误时先构建依赖包;本地通过而流水线失败时检查 Node 与 pnpm 版本是否匹配 .nvmrc。

限制:本技能面向 Elements 单体仓库的构建体系,不涉及其他平台或项目;具体收费、价格与性能数据暂未提供。