Fe engineering

前端工程基建技能路由

本技能是“路由层”，只负责快速定位到正确的工作流文档。执行任务时先做场景判断，再按指引加载对应 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 治理基线

决策树（简版）

1. 如果你还不知道项目现状，先阅读 references/stack-analysis.md。
2. 如果你要判断是否升级以及升级风险，接着阅读 references/docs-fetching.md。
3. 如果目标是构建链路迁移/升级，阅读 references/build-tool-upgrade.md。
4. 如果目标是业务代码重构，阅读 references/refactoring.md。
5. 如果目标是统一工程规范，阅读 references/dev-standards.md。
6. 如果目标是多包治理/提效，阅读 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，避免一次性加载全部文档。