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。