Nx 工作区生成器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/nx-workspace-generator-toolkit。
技能介绍
解决什么问题
在大型 monorepo 里,手工新增一个库或应用很容易出现配置漂移:生成的 project.json 漏字段、tsconfig.json 继承关系不一致、新入口没有挂进 nx.json 的 target 默认值,于是 CI 时才发现问题。团队反复复制粘贴模板,后续升级 Nx 或调整依赖图时,这些手写脚手架又变成维护负担。
技能如何工作
- 通过
@nrwl/devkit在当前 Nx workspace 内创建和管理自定义 generator,生成的库或应用与项目已有的 target、executor 和标签体系对齐。 - 生成过程中利用 TypeTree 描述文件结构,并对输入参数执行
schema.json校验,在写盘前拦截缺少必填项、类型错误或路径不合法的问题。 - 脚手架阶段会参考当前 dependency graph,判断新模块与已有项目之间的依赖方向,避免生成循环依赖或断开 target 链。
- 推荐结合 Nx quickstart 与本地 generator recipe 文档,在
npx nx init后的存量 npm / pnpm / yarn workspace 上增量使用,无需为接入 Nx 重写现有脚本。
适用边界与注意点
- 目标环境需已能运行 Node.js,且仓库已具备 Nx 工作区基础;它负责生成和校验 generator,不替代 Nx 自身的缓存与调度。
- 生成内容仍受现有
nx.json、project.json和 tsconfig 继承结构约束,历史仓库中的自定义 target 需要提前梳理清楚。
使用场景
- 在已有 npm/pnpm/yarn 工作区里,要把团队内部库做成可复用的 Nx generator。
- 升级 Nx 后统一生成的 `project.json`,按 `schema.json` 校验团队传入的参数。
- 批量新建应用时,要确保新入口遵循 TypeTree 描述并接入现有 target。
- 调整 monorepo 结构时,生成前根据 dependency graph 避免循环依赖。
适合人员
- 维护大型 Nx monorepo 的前端工程师,需要统一库和应用的生成模板。
- 负责 CI 的开发者,想把配置错误在生成阶段提前拦截。
- 把公共工具沉淀为本地 generator 的工具链负责人。
- 需要新建多个 Angular/React 应用的团队,希望自动接入 Nx target。