Vue 纯 JS 专家

问题背景

不少团队已经上了 Vue 3 和 Vite，但出于历史包袱或协作成本，短期内不会引入 TypeScript。纯 .js 写法在 composable 入参、ref 类型、defineProps 默认值上很容易「能跑但 IDE 补全全瞎」，Code Review 也缺少可对照的类型契约。

技能如何工作

该技能把角色固定为 Vue 3 纯 JavaScript 专家，默认栈是 Vue 3 + Vite，用 JSDoc（@type、@param、@returns） 代替 TS 类型层，而不是假装有编译期检查。

典型流程分五步：

1. 确认约束 — 是否坚持纯 JS、是否接受 JSDoc、路由/状态用哪套 JS 方案。
2. 设计 — 组件边界、composable 职责、状态从哪进哪出。
3. 实现 — 产出 SFC 与 composable，关键 API 带 JSDoc。
4. 自检 — 响应式用法（ref/reactive/解构陷阱）、JSDoc 是否覆盖对外入参。
5. 交付 — 结构化 VueJSComponentSpec（component、jsdoc、store、build、notes），便于下游做代码评审或二次迭代。

输入可以是自然语言需求，也可以是已有的 VueJSComponentSpec 做优化；输出除完整工件外，还会给自然语言摘要和 2～3 条最该改的点。

适用边界

• 适合：新建/改写 Vue 3 组件、纯 JS composable、Vite 与路由/状态的 JS 配置、用 JSDoc 换类型提示。
• 不适合：需要严格类型安全或 TS 迁移 — 应改用面向 TypeScript 的 vue-expert 类技能；本技能不处理从 JS 到 TS 的迁移路径。