核心用法
本技能提供12阶段React生产工程方法论，非API文档式参考，而是带决策树、评分系统和模板的实战工程指南：
Phase 1-2 架构与结构：16项健康检查清单、框架选型决策矩阵（Vite/Next/Remix/Astro）、特性隔离目录结构（features/模式）、7条结构铁律。
Phase 3-5 组件与状态：组件解剖模板（8步标准写法）、复合组件/Render Props模式、状态决策树（server≠client state）、Zustand/TanStack Query实战模式。
Phase 6-7 类型与性能：严格TS配置（零any策略）、品牌类型防ID误用、性能预算（LCP<2.5s/Bundle<200KB）、P0-P3优化优先级栈、React Compiler迁移指南。
Phase 8-12 质量保障：三级错误边界架构、RHF+Zod表单标准、测试金字塔（Vitest→Playwright）、WCAG AA无障碍清单、生产部署P0-P1检查项、0-100质量评分体系。
显著优点
1. 决策框架驱动：每个技术点附带选择矩阵（如框架选型5规则、状态管理决策树），避免"看心情选型"。
2. 可量化质量：16项健康检查、8维度百分制评分、性能预算硬指标，适合技术债评估与晋升述职。
3. 2025技术栈：涵盖React 19 Compiler、Tailwind v4、TanStack Query v5、Biome等前沿工具。
4. 工程化闭环：从架构→代码→测试→监控的完整链路，含Sentry集成、CI检查项、预览部署等DevOps实践。
潜在局限
1. 生态锁定倾向：默认推荐Next.js/Vercel/shadcn/ui栈，对已有技术栈团队迁移成本未充分讨论。
2. 企业级场景覆盖不均：SaaS/Fintech/Healthcare等垂直领域需购买$47 Context Pack，核心skill偏通用。
3. 类组件遗留系统：迁移指南较简略，大型legacy codebase重构路径不够详尽。
4. 无SSR深层调优：Next.js App Router实践提及较少，服务器组件最佳实践待扩展。
适合人群
- Tech Lead/架构师：技术选型评审、团队代码规范制定、质量门禁设计
- 中高级前端工程师：从"能写React"进阶"能写生产级React"，系统补全工程化知识
- 全栈开发者：需要端到端部署认知，但非Node/运维专家
- 创业团队CTO：快速建立可扩展的前端工程基准
常规风险
1. 过度工程陷阱：小团队（<3人）严格遵循300行文件限制/50行JSX规则可能降低迭代速度，建议按项目阶段弹性调整。
2. 评分形式主义：质量评分若沦为KPI工具，可能引发"为高分而优化"行为，需配套代码评审文化。
3. 工具链更新滞后：React生态迭代快（如TanStack Router崛起），建议每季度复核决策矩阵时效性。
4. TypeScript构建性能：严格模式+大型项目可能出现tsc内存问题，需配合tsconfig增量编译策略。