用途:在视觉方向已确定后,执行 Web 前端工程任务,包括实现、集成、调试、构建、部署与验证,适用于 React、Vue、Vite、路由、浏览器验证及 CloudBase Web 集成。若任务涉及界面样式、布局、配色或字体,须先加载 ui-design 技能并输出设计规范,否则样式易退化为通用模板。
主要能力:按现有项目栈实现页面与组件;新项目默认以 Vite 为打包器;处理路由、数据加载、表单与构建配置;通过浏览器做冒烟与回归验证;在需要时接入 CloudBase Web SDK 与静态托管。
使用方式:先明确任务属于框架搭建、页面实现、调试、部署、验证还是 CloudBase 集成,并限定在 Web 应用范围内。遵循仓库的包管理器、脚本与 lint/test 约定,优先最小改动。改动前遵循变更安全协议与部署门禁。完成前须自检:tsc --noEmit 或 vue-tsc --noEmit、lint、构建、单测通过,并用 agent-browser 实际打开页面复现用户可见流程,记录路由、操作、预期与实际结果。CloudBase Web SDK 优先用 npm install @cloudbase/js-sdk,仅静态 HTML 或演示用 CDN;认证须用 SDK 内置能力,不要放进云函数。静态托管默认先构建、用相对资源路径、无服务端重写时用 hash 路由;History 模式 SPA 须将 404 错误文档设为 index.html,可用 manageHosting({ action: "setWebsiteDocument", indexDocument: "index.html", errorDocument: "index.html" }) 配置,再用 queryHosting({ action: "websiteConfig" }) 验证。
限制:不用于视觉方向设定、原型优先设计或纯美学探索;不用于小程序、原生 App 或纯后端服务;微信支付与公众号 OAuth 细节应使用 cloudbase-wechat-integration。禁止用 any、@ts-ignore 等绕过类型系统,不得用空 catch 掩盖失败或删除失败测试。若某层无法本地执行,须明确说明未验证步骤。