用途
vean-ui-develop 是 soybeanjs/vean-ui 仓库中关于 Vean 组件工作的自包含技能说明。它适用于任何创建、迁移、扩展、标准化、修复或审计 Vean 组件的任务,负责模式分类、阶段顺序、分层规则、交付面、生成工作流和收尾检查清单。
主要能力与规则
技能强调在编辑前先对任务进行分类:判断 aria 准入(行为族、仅 UI 被拒绝、或组合现有原语)、组件模式(多插槽基础、紧凑聚合、单类)、任务场景(新建、迁移/规范化、标准对齐、审计评估)和交付范围(仅 aria、仅 UI、完整交付面)。
仓库背景为 pnpm 工作区单仓,技术栈为 Vue 3 + TypeScript(严格模式)+ UnoCSS + @soybeanjs/cva,架构采用 aria/styled 分离,编译期依赖必须为 packages/ui -> packages/aria,aria 不得导入 UI。@vean/aria 负责逻辑、状态、无障碍和结构;@vean/ui 负责样式包装,使用 UnoCSS 与 cv()/scv(),组件名带 S 前缀。文档站为 ubean SSG,内置中英文 i18n。
技能定义了三种组件模式:多插槽基础组件(aria 暴露多个插槽原语,UI 通过 provide{Name}Ui 注入类)、紧凑聚合(结构稳定且数据驱动时使用,aria 通过 {Name}Compact 负责迭代、默认内容与结构编排,UI 包装保持轻薄)、单类组件(无 UiContext,直接从变体与 props.class 组合类)。
使用方式
工作流按阶段执行:阶段 0 分类模式、场景和范围;阶段 1 查找同模式参考实现并梳理迁移需保留的行为、状态、无障碍、插槽和公共 API;阶段 2 实现 aria(types.ts -> context.ts -> 基础插槽 SFC -> 可选 Compact -> index.ts);阶段 3 实现 UI(styles/{name}.ts -> types.ts -> 包装 .vue -> index.ts);阶段 4 更新导出并运行 pnpm sui gen catalog;阶段 5 补全交付面(示例、中英文文档、菜单常量、测试、必要时 e2e,以及 API/changelog 生成与翻译);阶段 6 运行 pnpm typecheck、pnpm lint、pnpm fmt 和最窄相关测试,并按 process.md 完成检查清单。
边界规则要求:不在 aria 中添加视觉令牌样式或工具类(几何布局内联样式除外),不在 UI 中添加 ARIA、role、tabindex、键盘交互或状态语义;不手改生成文件;先复用现有 composables、shared、types 和 @vueuse/core,确有必要新增时才说明理由;禁止 as any / @ts-ignore / @ts-expect-error;不得修改自动生成的 typed-router.d.ts。
适用场景
适用于在 vean-ui 仓库内新增组件、迁移复合组件、修复或扩展已有组件、进行标准对齐,以及对已发布组件按审计方法(七个检查维度 D1–D7、106 项、严重级别、验收状态和回归规则)进行评估。审计场景需加载 audit.md,按八步评估流程执行,存在 Blocker 时不得开始下一个组件。
限制
资料未提供该技能面向仓库外用户的安装方式、收费信息、独立运行平台或效果承诺,相关内容暂未提供。技能中的生成与翻译命令依赖仓库环境;翻译命令需要 Azure Translate 或 DeepL 凭证。