SuperAPI AI 工具集

engineering-onboarding

设计与创作

查看项目

更新于 10-16 01:31

技能介绍

用途:为加入消费设计系统团队的工程师创建入职指南。设计系统的工程师与设计师心智模型不同——工程师消费的是带版本的组件库与令牌系统的 API(导入、props、类型),而非在 Figma 中组合库;组件漂移通常起源于工程师本地包裹、硬编码数值或复制源码,因此入职是提升采用率最高杠杆的干预。

主要能力:该技能按固定结构生成指南,包括系统是什么、安装与设置、组件使用、令牌使用、系统缺所需组件时怎么办、测试、常见错误、前两周任务、快速参考与常见问题。核心原则:不包裹系统组件、不硬编码数值、不复制源码,先问再做。

必要用法:写指南前需先向团队收集框架、包管理器、令牌消费方式(CSS 变量、JS 导入、Tailwind theme、Sass 变量)、组件 API 模式、TypeScript 类型导出、测试工具、贡献路径与团队联系人等信息,并区分已文档化内容与口头知识。命令与代码需可直接复制执行,占位符用方括号标注。示例安装命令保持原样:npm install @[org]/[design-system-name]。

适用场景:新工程师入职、需要统一采用规范、减少本地变体与组件漂移时。

限制:具体框架、包名、测试工具、贡献流程均取决于团队实际配置;跨部门与团队信息需自行收集,技能不提供现成事实。组件数少于 5 个时需压缩指南,如合并安装与使用章节、去掉快速参考卡。