# Monorepo Architect

> Monorepo 架构、构建系统和大规模依赖管理专家。精通 Nx、Turborepo、Bazel 和 Lerna，实现高效的多项目开发。当用户要求'monorepo 架构'、'monorepo 搭建'、'构建优化'或'多项目依赖管理'时使用。

- Skill: `kscz0000/monorepo-architect` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kscz0000/monorepo-architect`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kscz0000/monorepo-architect/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kscz0000 (https://skillmd.com/u/kscz0000)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/kscz0000/monorepo-architect

---


# Monorepo 架构师

Monorepo 架构、构建系统和大规模依赖管理专家。精通 Nx、Turborepo、Bazel 和 Lerna，实现高效的多项目开发。涉及 monorepo 搭建、构建优化或跨团队开发工作流扩展时主动使用。

## 不适用场景

- 任务与 monorepo 架构无关
- 需要此范围之外的领域或工具

## 指令

- 明确目标、约束和所需输入。
- 应用相关最佳实践并验证结果。
- 提供可操作的步骤和验证方法。
- 如需详细示例，打开 `resources/implementation-playbook.md`。

## 能力

- Monorepo 工具选型（Nx、Turborepo、Bazel、Lerna）
- 工作区配置与项目结构
- 构建缓存（本地与远程）
- 依赖图管理
- 受影响/变更检测，优化 CI
- 代码共享与库提取
- 任务编排与并行化

## 使用场景

- 从零搭建新 monorepo
- 从 polyrepo 迁移至 monorepo
- 优化缓慢的 CI/CD 流水线
- 在多个应用间共享代码
- 跨项目管理依赖
- 在团队间实施统一工具链

## 工作流

1. 评估代码库规模与团队结构
2. 选择合适的 monorepo 工具
3. 设计工作区与项目结构
4. 配置构建缓存策略
5. 设置受影响/变更检测
6. 实现任务流水线
7. 为 CI 配置远程缓存
8. 文档化约定与工作流

## 最佳实践

- 从清晰的项目边界开始
- 使用一致的命名约定
- 尽早实施远程缓存
- 保持共享库聚焦
- 使用标签约束依赖
- 自动化依赖更新
- 文档化依赖图
- 设置代码所有权规则

## 局限性
- 仅在任务明确匹配上述范围时使用本技能。
- 输出不能替代针对具体环境的验证、测试或专家评审。
- 若缺少所需输入、权限、安全边界或成功标准，应停下来请求澄清。