核心用法
该技能专为 Web 前端工程化场景设计，适用于 React、Vue、Vite 技术栈的项目开发、调试、构建与部署全流程。核心工作流包括：明确执行层面（框架搭建/页面实现/调试/部署/验证/CloudBase 集成）、遵循项目既有技术栈与构建规范、通过浏览器层实际验证变更效果、以及按需集成 CloudBase Web SDK 与静态托管服务。
显著优点
1. 工程规范严格：强制 TypeScript 类型安全，禁止 any 绕过，要求 unknown + 类型守卫的严谨模式，从源头杜绝类型债务累积。
2. 质量门禁完善：建立双层验证机制——静态层（tsc/eslint/build 零警告）与运行时层（agent-browser 真实浏览器验证），确保交付可运行而非仅可编译。
3. CloudBase 深度集成：官方 SDK 支持，涵盖认证、数据、静态托管全链路，特别针对 SPA History 模式提供 404 回退配置指引，解决刷新 404 经典痛点。
4. 框架生态覆盖全面：React/Vue/Vite 主流技术栈均有专门指引，兼顾新项目初始化与存量项目维护场景。
5. 变更安全协议：强制执行变更声明、用户确认、事后验证的完整闭环，降低线上故障风险。
潜在缺点与局限性
1. 技术栈限定：聚焦 React/Vue/Vite 生态，对 Angular、Svelte、Solid 等其他框架支持有限，需自行扩展。
2. 设计能力边界：明确区分「工程执行」与「视觉设计」，UI 方向未定任务需前置加载 ui-design 技能，单技能无法独立完成从 0 到 1 的视觉系统构建。
3. 后端能力隔离：不包含云函数、CloudRun 等后端服务开发，纯后端任务需切换至对应技能。
4. 小程序/Native 排除：Mini Program、原生 App 开发不在本技能范围内。
适合的目标群体
- 前端工程师：负责 React/Vue 业务开发、组件封装、路由与状态管理实现。
- 全栈开发者：需要快速完成前端页面并集成 CloudBase 服务进行部署。
- 技术负责人：需要建立团队代码规范与质量门禁，强制 TypeScript 与验证流程落地。
- CloudBase 用户：已在或使用腾讯 CloudBase 平台，需要标准化的 SDK 集成与静态托管最佳实践。
常规使用风险
1. 类型系统误用风险：团队若习惯 any 快速绕过，初期适配严格规范会产生较高迁移成本。
2. 验证依赖环境：浏览器层验证需 agent-browser 工具支持，本地环境缺失时可能形成验证盲区，需显式声明未验证项。
3. SPA 路由配置遗漏：History 模式项目若漏配 404 error document，将导致生产环境子路由刷新失效，需严格遵循文档中的 MCP 工具配置步骤。
4. 构建输出路径冲突：多技能协作时需注意相对路径与绝对路径的兼容性，避免静态托管资源 404。
5. 跨技能引用复杂度：涉及认证、支付、UI 设计时需跳转至关联技能，多技能协同对开发者的上下文切换能力提出更高要求。