Monorepo 管理

要解决什么问题

多仓库时代，公共库改一处就要连锁发版、工具链各搞一套，构建与测试也容易随包数量线性变慢。Monorepo 把多个包和应用收进同一仓库，用原子提交和共享依赖把变更对齐，但目录划分、缓存、版本发布和 CI 路径过滤都会变成日常坑。

技能如何帮你推进

本技能面向「搭新项目、从 multi-repo 迁移、压构建/测试时间、管共享依赖、定代码共享策略、配 CI/CD、发包与排错」等场景。工作方式很直接：先和你对齐目标、约束和已有输入（现有仓库结构、包管理器、CI 平台等），再按 monorepo 常见实践给出可执行步骤和怎么验收；需要更完整的模式与示例时，会指向 resources/implementation-playbook.md。

典型覆盖点包括：

• 仓库与包边界怎么划，避免「一个大杂烩」
• 统一 lint / test / build 工具链
• 依赖 hoist、workspace 协议与版本策略
• CI 里按变更范围跑任务，而不是全量扫一遍
• 发布流程与 monorepo 特有故障（循环依赖、错误的工作区引用等）的排查思路

适用边界

任务与 monorepo 管理无关（例如纯业务功能开发、与仓库结构无关的单包问题），或需要本技能范围外的其他领域/工具深度方案时，不必强行套用本技能。它聚焦 monorepo 的架构与工程化，而不是替代你选定的具体框架文档。