Web 开发
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tencentcloudbase-skills-web-development。
技能介绍
要解决什么问题
很多 Web 相关需求并不是「再画一版界面」,而是在既定技术栈里把页面、路由、构建和上线跑通,并在改动后能用浏览器复现用户路径。尤其是接 CloudBase Web SDK、静态托管部署,以及 React Router / Vue Router 的 History 模式时,容易出现子路由刷新报 NoSuchKey、登录逻辑误塞进云函数、或仅凭「能编译」就宣称完成等问题。
技能如何工作
本技能定义了一套工程执行契约:先区分任务是设计探索还是工程落地;涉及样式与视觉体系时必须先走 ui-design 并产出 Design Specification,再写 CSS/Tailwind。
核心能力包括:
- 在现有或新建 React / Vue / Vite 项目中实现页面、路由、表单与构建配置
- 按
frameworks.md、browser-testing.md做框架约定与浏览器级验证(含agent-browser) - 需要平台能力时接入 CloudBase:
npm install @cloudbase/js-sdk、认证走 SDK 内置能力,静态托管前先build,History SPA 需把托管 404 错误文档 指到index.html - 变更与发布前遵循同目录族的 Change Safety Protocol 与 Deployment Gate
工程宪法要求:TypeScript 禁止用 any 等方式绕过类型;宣称完成前须通过 tsc --noEmit、lint、构建,并对用户可见流程做浏览器检查并记录路由、动作与结果。
适用边界与注意点
- 适用:Web 前端实现、调试、构建部署、CloudBase Web 集成与冒烟验证
- 不适用:纯视觉方向探索(用
ui-design)、小程序/原生 App、纯后端服务;微信支付/OAuth 合约细节用cloudbase-wechat-integration - 同级技能(如
auth-tool-cloudbase、auth-web-cloudbase)需用本地相对路径加载,缺失时不要 HTTP 拉远程 SKILL
使用场景
- 产品 UI 已定稿,需在现有 Vite+React 仓库里实现列表页、路由跳转并在浏览器里跑通提交流程
- Vue Router History 模式站点部署到 CloudBase 静态托管后,用户刷新子路由出现 404,需改托管 404 文档配置
- 新接 CloudBase 环境 ID,要在前端初始化 Web SDK、复用登录技能并完成静态资源相对路径构建
- 改完表单校验与异步请求后,需按 browser-testing 用 agent-browser 记录路由、操作与控制台结果再收尾
适合人员
- 维护云开发静态站的全栈工程师:每周要改路由或页面逻辑并自己验证上线前构建与托管配置
- 接手遗留 React 项目的开发者:要在不放宽 TypeScript 的前提下补页面并证明 tsc、eslint、build 全绿
- 负责 CloudBase Web 登录集成的同学:需把认证留在 SDK 侧并对接 auth-tool/auth-web 同级技能而非写云函数登录
- 发布前有门禁要求的团队技术负责人:要求每次静态托管发布前走完 Deployment Gate 与变更安全确认