wot-ui 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。