SuperAPI AI 工具集

bulk-import

设计与创作

查看项目

更新于 10-15 23:40

技能介绍

用途:把现有代码库中的设计系统批量导入 Subframe。仅当用户明确要求一次性批量导入多个组件时使用;其他“把设计系统带入 Subframe”的需求应默认走 /subframe:design 的增量工具。两条路径底层是同一个 AI 代理,输出质量相同,批量导入只在确实需要单次 CLI 批量提交时节省编排时间。

主要能力:发现磁盘上的设计系统文件、按组件分组、生成清单并通过 CLI 上传。只处理视觉/展示层文件,包括纯 UI 组件、布局原语、主题/样式文件、Stories;排除取数据、调 API、管理应用状态的组件、页面级业务组件、非视觉工具函数与 hooks、测试文件。

使用方式:先确认 MCP 已认证(Claude Code 或 Codex 可运行 /mcp)。用 list_projects 获取项目 ID(多个项目必须让用户确认),用 generate_auth_token 配合所选项目的 teamId 获取令牌。随后发现文件、按组件分组(entrypoint、sourceFiles、supportingFiles),创建目录并写入清单:mkdir -p .subframe,清单路径为 .subframe/import-design-system.json,组件名必须唯一。上传前先打印组件名、主题文件、文件总数摘要。提交命令:npx @subframe/cli@latest import -p {PROJECT_ID} --manifest .subframe/import-design-system.json --auth-token {TOKEN}。该命令只提交异步导入任务,不会内联完成导入。

限制:该功能目前仅对部分团队开放;若 CLI 返回“Design system import is not enabled for this team”,说明未开通,应引导用户申请访问权限,不要重试或排查。MCP 工具不可用时,可让用户到 https://app.subframe.com/cli/auth 获取令牌和项目 ID。文件缺失会导致 CLI 中止;清单 JSON 格式错误应自行修复后重试。