用途:帮助评估或实施 JavaScript/TypeScript 项目的技术迁移、目标配置、项目规则与通用 workflow,并避免把不相关重构混入任务。先确认用户允许的操作范围与项目事实,再组合适用 references;只评估时不修改文件,允许执行时只做可验证的必要改动。
主要能力:references 分四类,可组合使用。migrations 描述从旧状态到新状态的转换,包括 Prettier 到 Oxfmt、ESLint 到 Oxlint、Jest 到 Vitest、TypeScript 项目 CJS 到 ESM、pnpm 升级到最新稳定版、NestJS 升级。profiles 负责项目级规则,含 nodejs-backend、nestjs-backend、react-csr。frameworks 负责可直接落地的目标配置,含 NestJS 的 package.json、tsconfig.json、nest-cli.json、.swcrc、Prisma Client、PM2、Dockerfile,以及 React CSR + Vite 的依赖、构建、类型检查、测试、Oxlint、Oxfmt、lint-staged。workflows 负责跨框架流程,含 docker-build、gitignore、dependencies-latest。
使用方式:先确认任务模式(只评估或执行修改),检查项目事实、用户约束和未提交改动,再按任务选择并读取 references;组合目标状态与本次操作范围,若与用户要求或项目事实冲突则以用户要求和项目事实为准并记录偏差。只评估时输出差距、风险和合理例外后停止;允许执行时先验证目标命令或配置真实可用,再实施最小改动、同步受影响调用方、局部验证,必要时全量验证,最后复查任务范围、旧技术残留和需幂等的命令。
适用场景:JS/TS 项目升级、现代化、技术迁移、模板同步或项目标准化。
限制:不得扩大到用户未授权的迁移或重构;不混入无关的 lint、format、测试框架、模块系统、Docker、CI、IDE 或业务代码重构;命令、包名或配置字段不可用时不得编造替代方案;沿用项目现有包管理器并同步维护锁文件与提交前检查。