用途:初始化或扩展项目设计系统,借助 Tailwind CSS 与 shadcn/ui 创建具备可访问性、风格一致的 UI 组件,并产出相关文档。适用场景包括首次搭建设计系统,以及向既有系统新增组件或模式。
主要流程与能力:
- 校验功能分支:先执行 git fetch origin main;若在 main 上,则执行 git checkout -b feature/design-system origin/main;若已在功能分支,则根据工作区是否干净选择 stash 后或直接执行 git rebase origin/main。
- 评估现状:检查 packages/ui/ 目录、shadcn/ui 配置 components.json、Tailwind 配置(v4 看 src/index.css 的 @theme,v3 看 tailwind.config.*)、现有组件与设计令牌,并向用户确认初始化还是扩展、需要哪些组件、是否有品牌规范或 Figma 设计、是否需要暗色模式。
- 重大变更时进行设计评审:由设计负责人、前端专家、产品策略角色就品牌、组件层级、令牌架构、技术架构与优先级给出建议,并在搭建前等待用户批准结构。
- 基础设施:可调用 /ui-design:design-system-setup 与 /frontend-mobile-development:tailwind-design-system,定义颜色、字体、间距、圆角、阴影、断点等令牌,配置运行时主题与暗色策略,按 primitives、layout、navigation、feedback、data-display、forms 等目录组织组件。
- 构建组件:可用 /ui-design:create-component,要求完整 TypeScript 类型、forwardRef、cn() 合并 className、响应式;并包含语义化标签、ARIA、键盘导航、焦点管理、WCAG AA 对比度与最小 44x44px 触控目标;每个组件需有渲染、属性、交互与可访问性测试。
- 审计与文档:可调用 /ui-design:accessibility-audit 与 /ui-design:design-review,随后编写组件目录、令牌参考、可访问性指南与上手说明。
- 提交使用约定式提交信息,例如 feat(ui): initialize design system with core components。
限制:该技能在提交后即停止,不应创建 PR、推送远端或运行代码审查;这些属于其他技能。建议继续运行 /review-code,再按需进入 /submit-pr。