SuperAPI AI 工具集

maestro-ui-codify

设计与创作

查看项目

更新于 10-15 20:11

技能介绍

用途:从已有代码库中提取设计系统,生成可复用的参考包(reference package),并把结果持久化为知识资产,便于后续实现与评审。

主要能力:采用四波(wave)工作流。第一波进行文件发现,扫描源目录中的 CSS/SCSS/JS/TS/HTML 文件并分类建立文件清单;第二波由三个智能体并行提取——Style Agent 输出 design-tokens.json(颜色、排版、间距、边框、阴影),Animation Agent 输出 animation-tokens.json(关键帧、过渡、缓动),Layout Agent 输出 layout-templates.json(网格/弹性布局、响应式断点、组件模式);第三波生成参考包,复制令牌文件并生成 preview.html 与 preview.css 作为交互式展示;第四波构建 knowhow-manifest.json、写入知识文件与 spec 条目并清理临时工作区。

使用方式:需提供源目录参数,可选 --package-name、--output-dir(默认 .workflow/reference_style)、--overwrite、-y/--yes。工作流通过生成 tasks.csv,再用 spawn_agents_on_csv 顺序执行各波次。输出写入指定目录,不修改被扫描的源代码文件。

限制:源路径必填且须为目录;若包目录已存在且未加 --overwrite 会被拒绝。动画提取为可选,缺失时发 W001。若样式与布局提取均失败,则跳过第三、四波并标记会话降级。完成前必须校验 design-tokens.json、layout-templates.json、preview.html、preview.css、knowhow-manifest.json 均存在,否则不得报告完成。