SuperAPI AI 工具集

figcraft-scenario-playbooks

设计与创作

查看项目

更新于 11-04 23:01

技能介绍

用途

本技能面向 FigCraft 的界面场景搭建,覆盖登录页、套餐卡、指标组件、导航、自适应容器、确认弹窗、空状态和字段错误状态等 8 条流程。使用时先从流程清单中选择当前任务,recipes.json 内含具体方法名称与参数;每条命令的证据记录实际目录,来源固定为 Figma 示例提交。技能所产出的图稿只代表视觉结构,不代表后端业务逻辑、点击交互或可访问性语义已经实现。

主要能力

  • 场景配方:提供 8 条界面流程,配合 recipes.json 中的方法与参数使用。
  • MCP 调用方式:先读取当前宿主工具 schema;内嵌编辑器就绪后,通过同一 MCP 服务的 create_node、set_properties 或 run_command 调用实际方法,参数封装以 tools/list 为准,不作猜测。
  • 返回 ID 与父子绑定:父 frame 先创建,保存实际返回的 id,再交给子节点的 create.parent。props 中的 x/y 相对父 frame 计算,不能把画布坐标直接当作子坐标。
  • 手册绑定标记:手册中的 capture:root 表示记住该步返回对象,{"$ref":"root.id"} 是手册绑定标记,必须替换成真实值,并非 FigCraft 原生变量语法。
  • 对象设置写法:node.set 使用 {"id": 实际ID, "props": {"width": 640}} 这类明确对象,不对未知当前选区执行宽泛修改。
  • 已有文件处理:已有文件跳过 newDocumentOnly,保留既有对象与当前画板,并为本次根 frame 安排空白位置。

使用方式

独立 CLI:先检查 figcraft-cli --version 以及 commands --json。技能不附带二进制文件,缺失时需按官方发行说明选择当前系统版本,并遵守安装授权。原生 CLI 使用 run steps.json --in input.figcraft --out new.figcraft,JSON 数组每项为 command/params;原生不会展开 $ref。

可选脚本:需要执行手册中的新建示例时,可运行本技能的 scripts/run_recipe.py:

python run_recipe.py --recipes recipes.json --scene mobile-login-wireframe --output new.figcraft

将两个路径换成本技能内的实际路径。--cli 可指定已核实的 CLI。该脚本需要 Python 3(Windows CI 使用 3.13),会分批执行原生命令,读取创建返回的 ID 以绑定后续参数,并利用临时检查点保存重开;不实现编辑器业务,不依赖 SDK,拒绝覆盖已有输出。已有文件可传 --input,但需先调整根 frame 位置和示例文案,当前示例坐标默认从原点开始。

检查点限制:CLI 检查点不会保留临时选择,因此步骤使用明确的 parent/id/ids,不能把选择状态当作跨进程契约。附带脚本仅用于独立文件操作,不能宣称宿主画面同步;可见编辑器仍须通过同一 MCP 会话逐步操作。

检查与交付

保存新工程后重开,用 node.get 检查真实节点、父子关系和文字,用 component.list 检查组件。自动布局须核对实际子节点位置、间距和填充宽度,不能只检查 layout 字段是否存在。用 export 输出目标根 frame 后再查看成图。按真实文案复核溢出、按钮含义与信息层级,替换示例价格和账号文案。assertions 仅适用于嵌入的示例,不代表任意屏幕与真实产品已通过验收。

相关技能与限制

遇到组件复用而非重复绘制、尺寸变化后再验收布局、带下一步的表单错误状态时,可读取技能商店工作流适配,使用对应的 Craft 方法并检查实际结果。上游技能不作为运行依赖。用户明确要求改变自动保存或移除指定协作成员时,可读取 main 的新增能力与权限边界;这两个新方法的业务和宿主验收尚未完成,不能因原生命令存在就推断浏览器能托管会话。

更具体的设计工作流:主题与语义令牌交付使用 figcraft-light-dark-token-card,图标可换可隐藏的复用按钮使用 figcraft-swappable-icon-button,正负零值柱图使用 figcraft-signed-bar-chart。独立安装命令:

npx skills add full-aigc-skills/figcraft-skills --skill 对应技能名

当前技能是开发候选,不能以目录存在作为市场发布或宿主同步已验收的依据。