核心用法
web-development 是腾讯云 CloudBase 官方维护的 Web 前端工程技能，覆盖 React、Vue、Vite 技术栈的实现、调试、构建与部署全流程。该技能采用"先设计后开发"的强制契约——任何涉及 CSS/Tailwind 的视觉任务必须先加载 ui-design 技能输出设计规范，禁止直接套用 AI 模板默认样式。
技能定义了四级工程铁律：
1. 类型安全：严禁 any 绕过，强制使用 unknown + 类型守卫或 Zod 校验；ESLint 禁用需经评审
2. 自证完工：tsc --noEmit → 构建 → 单元测试 → agent-browser 浏览器验证，缺一不可
3. 失败显性：禁止空 catch 块、禁止跳过失败测试、禁止"编译通过即完成"
4. Change Safety Protocol：任何代码变更前必须声明影响范围，静态托管发布前必须完成 Deployment Gate 检查
针对 CloudBase 平台集成，技能规定：
- Web SDK 优先 npm 安装，CDN 仅用于静态 HTML/演示片段
- 认证逻辑必须内置于前端，禁止下沉到云函数
- 关键陷阱防范：History 模式 SPA 部署时必须将静态托管的 404 错误文档指向
index.html，否则子路由刷新触发NoSuchKey错误
显著优点
- 工程纪律严明：通过"非协商条款"将类型安全、浏览器验证、部署检查固化为强制流程，显著降低 AI 生成代码的回归风险
- 平台深度整合：内置 CloudBase Web SDK 初始化规范、环境 ID 解析规则、静态托管配置指南，减少云原生项目的配置踩坑
- 防御性设计：显式列出 SPA 路由陷阱、样式跳过陷阱、认证下沉陷阱，并配套 MCP 工具调用示例，具备实操可执行性
潜在局限
- 适用范围收窄：明确排除小程序、纯后端服务、视觉方向探索类任务，需频繁切换至
ui-design、miniprogram-development等兄弟技能 - 验证依赖外部工具：浏览器级验证依赖
agent-browser工具，若环境缺失该工具则无法完成自证闭环 - CloudBase 生态绑定：静态托管配置、认证流程、SDK 初始化等建议深度耦合腾讯云 CloudBase 平台，跨云迁移成本较高
适合人群
- 使用 React/Vue/Vite 构建 CloudBase 托管 Web 应用的开发者
- 需要在前端工程化中强制执行 TypeScript 类型安全的团队
- 遭遇 SPA 路由 404、样式退化、认证架构混乱等典型问题的维护者
常规风险
| 风险点 | 说明 |
|--------|------|
| 类型逃逸 | 开发者可能因便利使用 `as any`，导致类型安全网失效 |
| 验证跳过 | 本地环境无法启动 `agent-browser` 时，易以"代码逻辑正确"为由跳过浏览器验证 |
| 环境 ID 混淆 | 将别名(alias)误传给 `cloudbase.init`，导致初始化失败 |
| 跨技能边界模糊 | 视觉任务未切至 `ui-design`、支付需求未切至 `cloudbase-wechat-integration`，导致职责错位 |