AGENT SKILL

vue-development-guides

A collection of best practices and tips for developing applications using Vue.js. This skill MUST be apply when developing, refactoring or reviewing Vue.js or Nuxt projects.

使用场景前端开发
License 许可
MIT
最近更新
2026-04-06
Stars
★ 0
Forks
0

01 前言 Front Matter

name
vue-development-guides
license
MIT
metadata
{ "author": "github.com/vuejs-ai", "version": "17.0.0" }
description
A collection of best practices and tips for developing applications using Vue.js. This skill MUST be apply when developing, refactoring or reviewing Vue.js or Nuxt projects.
compatibility
Requires Vue 3 (or above) or Nuxt 3 (or above) project

02 资源文件 5

03 SKILL.md 正文

Vue.js Development Guides

Tasks Checklist

  • [ ] Followed the core principles
  • [ ] Followed the defaults unless there is a good reason not to
  • [ ] Followed the reactivity best practices
  • [ ] Followed the component best practices
    • [ ] Followed the Vue SFC best practices
    • [ ] Kept components focused
      • [ ] Split large components into smaller ones when needed
      • [ ] Moved state/side effects into composables if applicable
    • [ ] Followed data flow best practices

Core Principles

  • Keep state predictable: one source of truth, derive everything else.
  • Make data flow explicit: Props down, Events up for most cases.
  • Favor small, focused components: easier to test, reuse, and maintain.
  • Avoid unnecessary re-renders: use computed properties and watchers wisely.
  • Readability counts: write clear, self-documenting code.

Defaults (unless the user says otherwise)

  • Prefer the Composition API over the Options API.

Reactivity

IMPORTANT: You MUST follow the references/reactivity-guide.md for reactive state management when creating, updating a component or a composable.

Components

IMPORTANT: You MUST follow the references/sfc-guide.md for best practices when working with Vue SFCs.

  • Prefer Vue Single-File Components (SFC) using <script setup lang="ts"> (TypeScript) by default.
  • In Vue SFCs, keep sections in this order: <script> → <template> → <style>.

Keep components focused

Split a component when it has more than one clear responsibility (e.g. data orchestration + UI, or multiple independent UI sections).

  • Prefer smaller components + composables over one “mega component”
  • Move UI sections into child components (props in, events out).
  • Move state/side effects into composables (useXxx()).

NOTE: This rule also applies to the entry component (e.g. App.vue) in a Vue / Nuxt project by default.

Data Flow

IMPORTANT: You MUST follow the references/data-flow-guide.md for passing and receiving data between components using:

  • Props
  • Emits
  • v-model
  • provide/inject

For sharing data across the app, please follow the references/state-management-guide.md and consider using a Store for state management solution.

04 同仓库更多 Skills

superhealth
superhealth/skills-hub

vercel-react-best-practices

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

前端开发
★ 0
superhealth
superhealth/skills-hub

vue-testing-best-practices

Use for Vue.js testing. Covers Vitest, Vue Test Utils, component testing, mocking, testing patterns, and Playwright for E2E testing.

测试与质量前端开发
★ 0
superhealth
superhealth/skills-hub

vue-router-best-practices

Vue Router 4 patterns, navigation guards, route params, and route-component lifecycle interactions.

前端开发
★ 0
superhealth
superhealth/skills-hub

vue-pinia-best-practices

Pinia stores, state management patterns, store setup, and reactivity with stores.

前端开发
★ 0
superhealth
superhealth/skills-hub

vue-options-api-best-practices

Vue 3 Options API style (data(), methods, this context). Each reference shows Options API solution only.

开发工程师前端开发后端与接口
★ 0
superhealth
superhealth/skills-hub

vue-best-practices

MUST be used for Vue.js tasks. Strongly recommends Composition API with `<script setup>` and TypeScript as the standard approach. Covers Vue 3, SSR, Volar, vue-tsc. Load for any Vue, .vue files, Vue Router, Pinia, or Vite with Vue work. ALWAYS use Composition API unless the project explicitly requires Options API.

开发工程师前端开发后端与接口
★ 0