monorepo-architect

Monorepo Architect - 单体仓库架构专家

技能概述

Monorepo Architect 是专注于单体仓库架构设计的 AI 技能，帮助开发者从零搭建、优化和迁移 monorepo 项目，精通 Nx、Turborepo、Bazel 和 Lerna 等主流工具。

适用场景

1. 从零搭建 monorepo 项目

当你需要将多个相关项目整合到一个代码仓库中时，该技能可以帮你选择合适的工具（如 Nx 或 Turborepo），设计清晰的工作区结构，配置构建缓存策略，并设置增量构建以提升开发效率。

2. 优化缓慢的 CI/CD 流水线

如果你的项目构建时间过长，该技能可以帮你配置受影响检测（affected detection），实现远程缓存，优化任务并行化，让 CI 只构建和测试发生变化的代码部分。

3. 多项目间代码共享与依赖管理

当多个应用需要共享组件、工具函数或业务逻辑时，该技能可以帮你设计合理的代码结构，管理跨项目依赖，确保共享代码的版本一致性和可维护性。

核心功能

1. Monorepo 工具选型与配置

根据项目规模、团队技术栈和性能需求，帮你选择最适合的 monorepo 工具，并进行完整的 workspace 配置，包括项目边界划分、命名规范和依赖图管理。

2. 构建缓存与 CI 优化

配置本地和远程构建缓存，实现智能的受影响检测，让 CI 系统只运行与代码变更相关的测试和构建任务，大幅缩短反馈时间。

3. 任务编排与依赖管理

设计和实现复杂的项目间任务编排，处理共享库的提取和维护，自动化依赖更新流程，确保整个 monorepo 的健康运行。

常见问题

Nx 和 Turborepo 应该如何选择？

选择主要取决于技术栈和团队需求。Nx 对 TypeScript/JavaScript 生态支持最完善，提供丰富的代码生成器和可视化依赖图，适合前端为主的项目。Turborepo 更轻量灵活，与现有工具集成简单，适合已使用其他工具（如 Vite、esbuild）的项目。两者都支持远程缓存和增量构建，对于新项目建议优先试用 Nx，功能更全面；对于已有构建工具的项目，Turborepo 集成成本更低。

小团队需要 monorepo 吗？

Monorepo 并非只适合大团队。小团队同样可以从代码共享、统一工具链和简化协作中受益。如果你有 2-3 个相关项目需要共享代码，或者希望保持一致的代码规范和开发体验，monorepo 是合理的选择。建议从小规模开始，选择配置简单的工具（如 Turborepo 或 pnpm workspace），随着项目增长再逐步引入更高级的功能。

如何从多仓库迁移到 monorepo？

迁移可以分阶段进行：1）评估依赖关系，确定迁移优先级；2）创建新的 monorepo 仓库，配置工具链；3）逐个迁移项目，从小而独立的开始；4）调整项目间的导入路径；5）配置 CI 只检测变更的项目。迁移期间可以保留双仓库运行，逐步切换流量。务必提前做好分支策略和发布流程的规划。