核心用法
web-development 是腾讯云 CloudBase 官方提供的 Web 前端工程化技能,定位于"设计方向已确定后的工程执行阶段"。其核心工作流包括:
1. 工程路径选择:在既有 React/Vue 项目中按现有约定开发;新项目默认采用 Vite 构建工具
2. 框架规范遵循:强制 TypeScript 严格模式,禁止 any 类型绕过;要求 tsc --noEmit、eslint、构建命令全部通过
3. 浏览器级验证:所有涉及渲染、路由、表单、认证的变更必须通过 agent-browser 工具进行实际页面验证,代码审查不能替代运行验证
4. CloudBase 集成:提供 Web SDK 接入、静态托管配置(含 SPA History 模式 404 回退)、认证流整合
显著优点
- 来源权威性:T1 级别,直接来自腾讯云 CloudBase 官方技能仓库
- 安全基线严格:强制"变更安全协议"与"部署门禁"双检查,杜绝"代码编译即完成"的草率交付
- 类型安全铁律:明确禁止
any、@ts-ignore、// eslint-disable等逃逸舱口,要求unknown+ 类型收窄 - 运行时验证闭环:区分"构建层验证"与"浏览器层验证",强制记录验证路径、预期结果与实际结果
潜在局限与风险
- 前置依赖重:必须在设计方向明确后使用,视觉探索阶段需先加载
ui-design技能 - 生态绑定深:静态托管、认证、支付等深度整合 CloudBase 平台,跨云迁移成本较高
- 验证门槛高:本地无法运行时(如依赖付费 API、后端凭证缺失)需显式声明未验证项,不能模糊带过
- SPA 路由陷阱:History 模式需手动配置 404 错误文档指向
index.html,否则生产环境直接访问子路由会报NoSuchKey
适合人群
- 使用 CloudBase 静态托管的 React/Vue 企业级项目团队
- 需要强制类型安全与工程规范的中小前端团队
- 接受腾讯云生态绑定、追求交付确定性的工程化场景
常规风险提示
- 认证边界误用:禁止将 Web 登录逻辑下沉到云函数,必须通过
auth-tool/auth-web处理 - CSS 前置检查:任何样式/布局实现前必须先加载
ui-design技能输出设计规范,否则回退到 AI 模板默认值 - 部署后验证缺失:静态托管发布必须通过
deployment-gate.md检查,禁止仅依赖构建成功即标记完成