weapp-vite Vue SFC Best Practices

What it does

Provides a focused handbook for authoring Vue Single File Components (SFCs) within weapp-vite miniprogram projects. It helps developers structure SFCs so they compile predictably, keep runtime behavior correct, and maintain TypeScript types and .weapp-vite outputs in sync. The skill captures practical rules (use <script setup lang="ts">, prefer JSON macros for app/page/component metadata), template compatibility checks, and minimal verification steps to validate SFC changes.

When to use it

Use this skill when diagnosing SFC compile or runtime errors, deciding between JSON macros or <json> blocks, configuring page meta via definePageMeta, or troubleshooting drifting typed outputs (typed-router.d.ts, components.d.ts). It is also useful when aligning SFC conventions with repo-level AGENTS.md or existing dist/docs.

What's included

• Scripts: none detected in the skill folder (has_scripts=false).
• References: yes — the repo includes references like macro-config-checklist.md and template-compat-matrix.md.
• Instructions: the skill body provides a stepwise diagnostic flow (determine compile vs runtime vs tool issues), concrete rules for JSON macro usage, template compatibility constraints, and completion checks to ensure macros and types are synced.

Compatible agents

Best fit for developer-assistant agents with code and repo access (Copilot/Codex/Claude Code/GitHub CLI-enabled agents) that can read repo files and suggest code fixes or validation commands.