用途:为前端项目提供统一开发规范,约束 AI 生成的代码风格与工程实践,主要面向后台管理系统,并附带 React/Ant Design 高频陷阱的规避指引。
主要能力: UI 风格约束:禁止蓝紫霓虹渐变、发光描边、玻璃拟态、大面积渐变、赛博/暗黑科技风、UI 文案使用 emoji;后台默认使用组件库默认主题,配色以黑白灰加一个主色点缀,动效克制。 技术栈约定:Vue 首选(Vue 3 + TypeScript、Vite、Vue Router 4、Pinia、Element Plus),React 备选(React 18 + TypeScript、Vite、React Router 6、Zustand、Ant Design)。 编码规范:组件用 script setup lang="ts";组件文件 PascalCase.vue,Composables 用 useXxx.ts,Store 用 useXxxStore.ts;状态管理使用 Pinia setup 写法。 交互状态:必须处理 loading、empty、error、disabled、submitting 等状态。 TypeScript:API 工具函数支持泛型,调用处指定泛型或做类型断言,禁止用 as any 绕过。 性能优化:大列表虚拟滚动、路由懒加载 () => import()、computed 缓存、大数据用 shallowRef,请求防抖可用 @vueuse/core 的 useDebounceFn。 目录结构:src 下含 assets/styles、api、components、composables、router、stores、types、utils、views 等。 样式管理:.vue 的 style 块不超过 20 行,tsx 内联样式不超过 20 行,共享样式抽到 src/assets/styles/ 按模块拆分。 请求体完整性:UI 可选字段必须全部传入请求体,用 TypeScript interface 约束。 错误处理:非成功响应必须统一提示,网络异常用 try/catch 捕获处理。 类型复用:通用类型(如 PageResponse)统一放 @/types/common.ts。 React/antd 陷阱:controlled 与 uncontrolled 误用、Tree defaultExpandAll 被 setState 重置、useEffect 双轮询冲突、跨组件状态同步可用 revision counter、异步超时建议改后端 trigger + polling 模式。
使用方式:资料未提供该技能的具体安装或调用命令。
适用场景:后台管理系统前端开发、AI 辅助生成前端代码的规范约束。
限制:资料未提供收费、价格、平台支持等信息;部分约定依赖 Vue 3、Pinia、Element Plus 或 React 18、Zustand、Ant Design 等特定技术栈。