用途:在 monorepo 中导航、管理和优化,适用于多包/多应用共享代码(UI 组件、工具、类型、API 客户端)、构建缓慢因每次全量重建、从多仓迁移到单仓、需协调版本发布 npm 包以及团队跨包统一工具链的场景。
主要能力: 影响分析:判断共享包变更后哪些应用会受影响,追踪依赖链,生成 Mermaid 依赖图并估算影响范围。 选择性执行:仅对受影响包运行测试/构建,按 git ref 过滤变更文件,CI 中跳过未变更包。 构建优化:远程缓存(Turborepo/Vercel、Nx Cloud)、增量构建的输入/输出配置、依赖感知并行调度与产物共享。 发布:用 Changesets 协调版本、自动生成每包 changelog、预发布通道及发布时替换 workspace:*。
使用方式:配置或分析前需确认工具(Turborepo、Nx、pnpm workspaces 或 Changesets)、任务类型(影响/依赖分析、构建优化或发布设置)以及仓库根路径和用于“受影响”判断的基线 git ref。可用脚本包括 dependency_graph.py 生成依赖图、impact_detector.py 检测受影响包、package_analyzer.py 分析包结构与健康度,命令示例:python scripts/dependency_graph.py . --focus @repo/ui --direction dependents、python scripts/impact_detector.py . --ref origin/main --affected-only、python scripts/package_analyzer.py . --only-shared。按需加载 references/tooling-and-configuration.md(工具选型、仓库结构、turbo.json 与 pnpm-workspace 配置、远程缓存、受影响 CI 工作流、Changesets 发布、多仓迁移)和 references/operations-and-best-practices.md(常见陷阱、最佳实践、排错与成功标准)。
限制:不覆盖应用级构建配置(webpack、Vite、esbuild 内部,见 performance-profiler)、超出 monorepo 过滤范围的 CI/CD 管道设计(见 ci-cd-pipeline-builder)、Git 分支策略与发布流(见 release-manager)、依赖漏洞扫描与许可证审计(见 dependency-auditor)。可与这些技能集成:为 CI 提供过滤模式与缓存配置、为发布管理触发 changeset version/publish、为依赖审计导出包依赖树、为性能分析提供每包构建耗时、为 changelog 生成与债务跟踪提供变更摘要和耦合热点。