wj100 前端工程基建技能路由
本技能是“路由层”，只负责快速定位到正确的工作流文档。执行任务时先做场景判断，再按指引加载对应 references/*.md。
覆盖范围
- 技术栈识别与技术画像输出
- 最新官方文档/变更日志获取
- 构建工具链迁移与升级
- 系统性重构与自动化改造
- 开发规范、代码风格、提交流程统一
- Monorepo 治理（pnpm workspace / Turborepo / Nx）
场景路由表
| 场景 | 读取文件 | 执行动作 |
|---|---|---|
| 先摸清项目：框架、构建工具、测试、状态管理 | references/stack-analysis.md |
按步骤生成“技术画像” |
| 需要拿最新文档、迁移指南、breaking changes | references/docs-fetching.md |
用 Context7 + Web 搜索做证据化结论 |
| 要做 Webpack/CRA/Vue CLI/Angular CLI 升级迁移 | references/build-tool-upgrade.md |
执行“预检查 → 迁移 → 验证 → 清理” |
| 要进行代码/架构重构（含自动化批改） | references/refactoring.md |
先影响分析，再分批重构与验证 |
| 要统一 ESLint/Prettier/Husky/Commitlint/TSConfig | references/dev-standards.md |
一次性落地工程规范 |
| 要拆多包、做共享包、启用缓存与增量构建 | references/monorepo.md |
建立 Monorepo 治理基线 |
决策树（简版）
- 如果你还不知道项目现状，先阅读
references/stack-analysis.md。 - 如果你要判断是否升级以及升级风险，接着阅读
references/docs-fetching.md。 - 如果目标是构建链路迁移/升级，阅读
references/build-tool-upgrade.md。 - 如果目标是业务代码重构，阅读
references/refactoring.md。 - 如果目标是统一工程规范，阅读
references/dev-standards.md。 - 如果目标是多包治理/提效，阅读
references/monorepo.md。
快速开始（最常见：技术栈分析）
在项目根目录执行：
# 1) 基础环境
node -v
npm -v || true
pnpm -v || true
yarn -v || true
# 2) 关键文件探测
ls -la
ls -la package.json tsconfig.json vite.config.ts webpack.config.js angular.json nuxt.config.ts next.config.js 2>/dev/null
# 3) 依赖摘要（需要 jq；无 jq 时改用 node -p）
jq '.dependencies, .devDependencies' package.json 2>/dev/null
然后严格按 references/stack-analysis.md 里的“检测矩阵”和“技术画像模板”输出结论。
执行约束
- 当需要进行构建工具升级时，阅读
references/build-tool-upgrade.md。 - 当需要拉取最新官方文档与迁移说明时，阅读
references/docs-fetching.md。 - 当需要进行系统重构与自动化改造时，阅读
references/refactoring.md。 - 当需要统一开发规范与提交流程时，阅读
references/dev-standards.md。 - 当需要实施 Monorepo 治理时，阅读
references/monorepo.md。
每次只加载与当前目标直接相关的 reference，避免一次性加载全部文档。