AgentSkillsCN

Vue Spec

@markuplint/vue-spec的维护任务。

SKILL.md
--- frontmatter
description: Maintenance tasks for @markuplint/vue-spec
globs:
  - packages/@markuplint/vue-spec/src/**/*.ts
alwaysApply: false

vue-spec-maintenance

Perform maintenance tasks for @markuplint/vue-spec: add global attributes, add element-specific overrides, and update Vue extended specifications.

Input

$ARGUMENTS specifies the task. Supported tasks:

TaskDescription
add-global-attributeAdd a new Vue global attribute
add-element-overrideAdd an element-specific attribute override

If omitted, defaults to add-global-attribute.

Reference

Before executing any task, read docs/maintenance.md (or docs/maintenance.ja.md) for the full guide. The recipes there are the source of truth for procedures.

Also read:

  • •ARCHITECTURE.md -- Package overview, ExtendedSpec structure, and integration points
  • •src/index.ts -- The ExtendedSpec definition (source of truth)

Task: add-global-attribute

Add a new Vue global attribute. Follow recipe #1 in docs/maintenance.md.

Step 1: Identify the attribute

  1. •Determine the attribute name, type, and description
  2. •Determine if the attribute is conditional (requires a CSS selector condition)

Step 2: Add the attribute

  1. •Read src/index.ts
  2. •Add a new entry under def['#globalAttrs']['#extends']
  3. •Set the type field (e.g., 'NoEmptyAny')
  4. •Set the description field
  5. •If conditional, add a condition field with a CSS selector (e.g., '[v-for]')

Step 3: Verify

  1. •Build: yarn build --scope @markuplint/vue-spec
  2. •Test: yarn test --scope @markuplint/vue-spec

Task: add-element-override

Add an element-specific attribute override. Follow recipe #2 in docs/maintenance.md.

Step 1: Identify the element

  1. •Determine the element name and the override properties
  2. •Check the ExtendedSpec type in @markuplint/ml-spec for available override fields

Step 2: Add the override

  1. •Read src/index.ts
  2. •Add a new entry to the specs array with the element name and override properties
  3. •Example: { name: 'component', possibleToAddProperties: true }

Step 3: Verify

  1. •Build: yarn build --scope @markuplint/vue-spec
  2. •Test: yarn test --scope @markuplint/vue-spec

Rules

  1. •Only export an ExtendedSpec object — no parsing logic belongs in this package.
  2. •Global attributes go under def['#globalAttrs']['#extends'] — this is the standard location for framework-specific global attributes.
  3. •Element overrides go under the specs[] array — each entry must have a name field identifying the target element.
  4. •Use the condition field with CSS selectors for conditional attributes — e.g., '[v-for]' restricts an attribute to elements with the v-for directive.
  5. •Add JSDoc comments to document the purpose of new attributes or overrides.