SoybeanUI 组件开发技能是 SoybeanUI 组件工作的统一来源,负责模式分类、阶段顺序、分层规则、交付面、生成流程与收尾检查。适用于创建、迁移、扩展、规范化、修复或审计 SoybeanUI 组件的任务。
用途与架构:仓库为 pnpm workspaces 单仓(私有根 + 9 个子工作区),技术栈为 Vue 3 + TypeScript(strict)+ UnoCSS + @soybeanjs/cva,采用 headless 与样式分离。编译期依赖为 packages/ui -> packages/headless,headless 不得导入 UI。@soybeanjs/headless 负责逻辑、状态、无障碍与结构,无样式;@soybeanjs/ui 为样式包装,使用 UnoCSS 与 cv()/scv(),组件带 S 前缀;apps/docs 基于 Vite + vite-ssg + unplugin-vue-markdown + markdown-exit。
主要能力:组件模式分为多插槽基础组件、紧凑聚合(如 accordion、card、dialog 等)与单类组件(如 button、link)。工作流包括新建/迁移组件、修复或扩展现有组件、对已发布组件做审计评估。边界规则要求 headless 不写样式、UI 不写 ARIA/role/tabindex/键盘语义,不手改生成文件,新增 composable 前先检查仓库工具与 @vueuse/core。
使用方式:先分类模式、场景与范围,再找本地参考实现。实现按 types.ts -> context.ts -> 基础槽 SFC -> 可选 {Name}Compact -> index.ts,UI 按 styles/{name}.ts -> types.ts -> 包装 vue -> index.ts。导出后运行 pnpm sui headless 与 pnpm sui ui;交付面包含 playground、英文/中文文档、菜单与测试。公共 API 变更运行 pnpm sui api,非英语区运行 pnpm sui api-translate -- --locale <locale>;变更日志运行 pnpm sui changelog 及 changelog-translate。验证运行 pnpm typecheck、pnpm lint、pnpm fmt 与 pnpm vitest packages/ui/test/specs/components/{component}.spec.ts。构建与开发命令包括 pnpm dev:playground、pnpm dev:docs、pnpm build、pnpm test、pnpm test:e2e。
限制:资料未提供收费、价格、平台支持范围与效果数据;详细规则需查阅 layers.md、surfaces.md、e2e.md、process.md、audit.md 与 EXAMPLES.md,TypeScript 风格与 Vue SFC 结构由其他技能负责。