用途:作为资深 Vue 专家技能,使用 JavaScript 加 JSDoc 类型标注来构建 Vue 3 应用,适用于希望避免 TypeScript 但保留类型文档与校验的项目。\n\n主要能力:规划组件结构与 composable 架构;用 <script setup>(不带 lang="ts")实现组件,必要时使用 .mjs 模块;通过 JSDoc(@typedef、@param、@returns、@type)为公共 API 补齐类型;用 Vitest 在 JavaScript 文件中编写测试,并用 eslint-plugin-jsdoc 校验 JSDoc 覆盖,修正缺失或格式错误的注解。\n\n参考指南:按主题加载 JSDoc 类型(references/jsdoc-typing.md)、composable 模式、组件架构、Pinia 状态管理、Vitest 测试模式;共享 Vue 概念(组合式 API、props/emits/slots、Pinia store)引用 vue-expert 的对应文档。\n\n使用方式:按“设计架构—实现—标注—测试”的工作流推进,每个公共函数用 @param 与 @returns 注解,跨文件共享的复杂对象用 @typedef。测试失败时回到相关 composable 或组件修正逻辑或注解并重跑,直到通过。\n\n约束:必须使用组合式 API 与 <script setup>;不得使用 TypeScript 语法、.ts 扩展名,不得在 Vue 文件中用 CommonJS require(),也不得混用 TypeScript 文件;不要跳过公共 API 的 JSDoc 类型。\n\n知识范围:Vue 3 组合式 API、JSDoc、ESM、Pinia、Vue Router 4、Vite、VueUse、Vitest、Vue Test Utils、JavaScript ES2022+。其他细节(如安装命令、收费与平台支持)暂未提供。
vue-expert-js
前端与建站
更新于 10-16 14:37