用途:为智能体提供 Vue 3(Composition API)与 Pinia 状态管理的开发与审查指南,用于构建、调试、重构或审查 Vue 3 应用、单文件组件(SFC)、Vue Router、Vite 及 Vue+TypeScript 项目。
主要能力:协助产出符合 Vue Style Guide 优先级 A/B 规则的代码,规避常见响应式陷阱,生成一致且强类型的 SFC。工作流分五步:感知项目环境与依赖(读取 package.json,确认 Vue 3.x、pinia、vue-router、Vite、TypeScript 与 Scoped CSS);加载编码规范与踩坑指南(references/coding-style.md、references/anti-patterns.md、references/patterns.md);架构推理与响应式规划;套用模板生成代码(assets/Vue3SFCComponentTemplate.vue);代码健检与自我校对。
关键防错:禁止直接解构 props 或 reactive() 对象,需用 toRefs(props) 或 toRef(props, 'name');解构 Pinia store 的 state 需用 storeToRefs(store),action 可直接解构;Vue 3.4+ 优先用 defineModel() 声明双向绑定;v-if 与 v-for 不可同节点混用,应用 template 包裹 v-for 或用 computed 预过滤。
使用方式:新组件使用 script setup,按项目配置加 lang="ts";注释与说明使用繁体中文(台湾),术语对齐。输出模板包含 template、script setup lang="ts"、style scoped 三段结构。
限制:资料未提供安装命令、收费、价格、平台与效果信息;具体依赖版本与项目配置需以实际项目为准。