SuperAPI AI 工具集

design-sync

设计与创作

查看项目

更新于 10-15 17:19

技能介绍

用途:design-sync 将用户的 React 设计系统仓库转换为 claude.ai/design 消费的格式并上传,让设计智能体此后使用真实组件(而非通用组件)构建设计,使产出与品牌一致,并能对应到工程师可发布的代码。

主要能力与产物:转换器从仓库自身的 dist/ 确定性构建产物,包括 _ds_bundle.js 与 _vendor/(设计智能体运行时渲染真实已编译组件)、styles.css、字体与 tokens、_ds_bundle.css、组件的 .d.ts 类型契约、.prompt.md 使用参考、.html 预览卡片,以及 _ds_sync.json 同步锚点(内容哈希,供后续同步跳过未变更组件并计算上传/删除)。核心原则是交付用户已构建的内容,bundle 来自其编译后的 dist/,而非重新实现。

使用方式:技能设有 DesignSync 工具读写用户的 claude.ai/design 项目;若工具调用出现授权错误,应原样转达其提示并按指引重试。首次同步会先说明:未找到已完成同步即为首次导入,默认进行高保真导入,可能耗时数小时,期间可随时打断;首次导入默认创建新项目,创建项目与本次上传各需一次批准,之后已验证组件随运行进度出现。目标项目选择有固定优先级:配置中已固定 projectId 则用之;否则默认新建;仅在用户明确要求时才复用既有项目,并提示可能覆盖或删除其中文件。确定目标后、上传前把 projectId 记录到 .design-sync/config.json。

工作流程:先探索仓库,再写 .design-sync/config.json,后用转换器确定性运行;支持 storybook 与 package 两种形状,按 .storybook/main.* 或故事文件检测,二者共用 package-build.mjs 作为转换入口、resync.mjs 作为再同步驱动。安装使用仓库自身包管理器与锁定文件(yarn --immutable、pnpm --frozen-lockfile、bun --frozen-lockfile、npm ci)。增量上传路径用于空项目:先一次批准,随后已验证组件边运行边出现,单次 write_files 不超过 256 个文件。

限制:渲染设计只接收 styles.css 的传递 @import 闭包,真实组件 CSS 必须由 styles.css 导入;外部脚本生成布局时需保证 package-validate.mjs 干净退出,且每个故事在上传前都要按评分标准评定;验证不能走脚本外的捷径。资料未提供平台支持范围、收费价格、具体效果与完整使用步骤,暂未提供,不得编造。