mcpField
N
nx-workspace-patterns

nx-workspace-patterns

github.com/wshobson开发41.9k11.0k 次安装2 周前更新
代码仓库

关于 nx-workspace-patterns

面向使用 Nx 管理单体仓库的团队，介绍工作区搭建与管理方法。内容涵盖项目边界、依赖管理、缓存和 CI 优化模式。

主要功能

  1. 01Nx 工作区架构
  2. 02项目边界与标签
  3. 03库类型组织方式
  4. 04通过 affected 命令优化 CI
  5. 05缓存与迁移模式

适用场景

  1. 01搭建 Nx 工作区
  2. 02仅测试受变更影响的项目
  3. 03管理单体仓库项目间依赖
  4. 04将代码库迁移到 Nx

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/wshobson/agents --skill nx-workspace-patterns

安装后在 Claude Code 中输入/nx-workspace-patterns确认已加载。

附带文件references/details.md

详细介绍

Nx 工作区模式

用于 Nx monorepo 管理的生产级模式。

何时使用此技能

  • 设置新的 Nx 工作区
  • 配置项目边界
  • 使用 affected 命令优化 CI
  • 实现远程缓存
  • 管理项目之间的依赖关系
  • 迁移到 Nx

核心概念

1. Nx 架构
workspace/
├── apps/              # Deployable applications
│   ├── web/
│   └── api/
├── libs/              # Shared libraries
│   ├── shared/
│   │   ├── ui/
│   │   └── utils/
│   └── feature/
│       ├── auth/
│       └── dashboard/
├── tools/             # Custom executors/generators
├── nx.json            # Nx configuration
└── workspace.json     # Project configuration
2. 库类型
类型用途示例
feature智能组件、业务逻辑feature-auth
ui展示型组件ui-buttons
data-accessAPI 调用、状态管理data-access-users
util纯函数、辅助工具util-formatting
shell应用启动shell-web

模板与详细的完整示例

完整的模板库和详细的完整示例位于 references/details.md。当你需要具体模板时，请阅读该文件。

最佳实践

应该做的
  • 一致地使用标签 - 通过模块边界强制执行
  • 尽早启用缓存 - 可显著节省 CI 时间
  • 保持库专注 - 单一职责
  • 使用生成器 - 确保一致性
  • 记录边界 - 帮助新开发者
不应该做的
  • 不要创建循环依赖 - 依赖图应保持无环
  • 不要跳过 affected - 只测试发生变化的内容
  • 不要忽视边界 - 技术债务会不断累积
  • 不要过度细化 - 平衡库的数量

评论

支持 Markdown