核心用法
本技能是CloudBase生态体系中的前端工程执行指南，主要覆盖以下场景：
1. 框架工程实施：React、Vue、Vite项目的搭建、组件开发、路由配置与状态管理
2. 调试与验证：浏览器端流程检查、回归测试、使用agent-browser工具进行实际页面验证
3. CloudBase平台集成：Web SDK接入（npm优先）、身份认证（auth-tool/auth-web）、数据服务、静态托管部署
关键执行路径
- 激活条件：产品方向已确定，需工程执行而非视觉探索；涉及浏览器验证、CloudBase Web集成
- 前置依赖：任何CSS/Tailwind编写前必须先加载
ui-design技能输出设计规范 - 变更安全协议：代码修改前执行
change-safety-protocol，静态托管发布前完成deployment-gate检查
显著优点
1. 工程纪律严格：TypeScript零容忍策略——禁止any绕过类型系统，强制unknown+类型收窄，ESLint禁用需书面论证
2. 验证闭环完整：编译通过（tsc --noEmit + 构建零警告）≠ 完成，必须通过浏览器实际验证并记录检查项
3. CloudBase深度集成：规范的SDK初始化（完整EnvId解析）、静态托管SPA History模式配置（404回退index.html）、认证边界清晰划分
4. 风险前置识别：明确列出常见陷阱，如SPA路由404、NoSuchKey错误、混淆设计与工程阶段
潜在缺点/局限性
1. 适用范围受限：不覆盖小程序、原生App、纯后端服务；UI设计阶段需切换至ui-design技能
2. 强依赖CloudBase生态：SDK集成、静态托管、认证流程均围绕CloudBase平台设计，跨平台迁移成本较高
3. 验证门槛较高：要求agent-browser实际运行检查，在凭证缺失、后端未就绪场景下可能阻塞流程
4. 约束多于灵活：严格的类型纪律和变更协议对快速原型场景可能形成过度工程
适合人群
- 目标用户：使用CloudBase平台的React/Vue前端开发者、技术负责人、需要规范交付的工程团队
- 典型场景：已有设计稿的页面实现、历史模式SPA部署、CloudBase SDK集成调试、生产环境变更安全管控
常规风险
| 风险类别 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| 类型安全侵蚀 | `any`滥用导致编译时保障失效 | 代码审查+ESLint规则强制 |
| SPA路由404 | History模式未配置404回退文档 | 部署前`manageHosting`设置`errorDocument: "index.html"` |
| 变更未验证 | 仅编译通过即标记完成 | 强制执行浏览器验证+记录检查清单 |
| 设计工程混淆 | 视觉方向未定即进入编码 | 前置`ui-design`技能检查点 |
| 凭证/环境阻塞 | 本地无法运行完整验证流程 | 显式声明未验证步骤，不隐瞒缺口 |