# Wot UI Component Baseline

> wot-ui 组件开发公共基线。涉及组件目录结构、命名、源码为准、最小修改、验证收口或需要为组件创建、Demo、文档迁移提供统一约束时调用。

- Skill: `wot-ui/wot-ui-component-baseline` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wot-ui/wot-ui-component-baseline`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wot-ui/wot-ui-component-baseline/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: wot-ui (https://skillmd.com/u/wot-ui)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wot-ui/wot-ui-component-baseline

---


# wot-ui 组件公共基线

本 Skill 提供 wot-ui 组件相关任务的共享规则，供“创建组件”“创建 Demo”“文档一致性核对”“文档迁移”等 Skill 复用。

## 何时使用

- 用户要求遵循 wot-ui 既有组件结构与命名。
- 任务同时涉及组件源码、Demo 页、文档中的两个及以上区域。
- 需要统一判断“以什么为准”“改动范围到哪里为止”“最终如何验收”。

## 公共规则

### 1. 目录与文件约定

- 组件源码目录：`src/uni_modules/wot-ui/components/wd-<component>/`
- 组件主文件：`wd-<component>.vue`
- 类型文件：`types.ts`
- 样式文件：`index.scss`
- 全局类型声明：`src/uni_modules/wot-ui/global.d.ts`
- Demo 页面：`src/subPages/<component>/Index.vue`
- 中文文档：`docs/component/<component>.md`

### 2. 命名约定

- 组件目录与文件使用 `kebab-case`。
- 组件名使用 `wd-<component>`，Vue 全局组件名使用 `Wd<Component>`。
- 变量、函数使用 `camelCase`。
- 类型、接口、组件实例类型使用 `PascalCase`。

### 3. 事实来源

- 涉及 API 对齐时，以组件源码为事实来源。
- 涉及 Demo 整理时，以现有 Demo 页和组件真实能力为事实来源。
- 无源码或现有能力依据的内容不得主观补充为正式能力。

### 4. 改动原则

- 优先最小修改，避免无关重排。
- 先保证真实、可验证，再考虑结构统一。
- 如果任务只要求核对，不额外做迁移或重构。
- 如果任务是迁移，不重复发明新的展示规则，优先复用现有基线。

### 5. 验证收口

- 至少对当前修改文件做一次诊断或类型校验。
- 如果任务包含文档迁移或 Demo 重构，需确认无新增语法错误。
- 如果任务包含组件源码改动，需补充必要注册点或类型声明检查。

## 适用边界

- 本 Skill 不直接替代具体工作流。
- 创建新组件时，配合 `create-component`。
- 创建或重构 Demo 时，配合 `create-demo-page`。
- 做纯 API 一致性核查时，配合 `check-doc-component-consistency`。
- 做 Markdown 新规范迁移时，配合 `migrate-component-doc`。