SuperAPI AI 工具集

figma-context-reader

设计与创作

查看项目

更新于 10-16 02:22

技能介绍

Figma Context Reader 是一个只读型技能,用于把 Figma 上下文转化为有证据支撑的设计简报(design brief),主要服务于 UI/UX 实现、审计和设计系统相关工作。

用途 当用户提供 Figma URL、选中节点、文件 key、截图或导出文件,或已连接的 MCP 选择时,可使用该技能读取并总结 Figma 设计上下文。该技能为只读,任何修改类操作应转交 figma-canvas-editor 或 figma-design-system-sync。

主要模式

  • frame-brief:总结选中的画板(frame)或页面。
  • component-brief:总结组件、变体(variants)、属性(props)与约束(constraints)。
  • token-brief:总结变量、样式、颜色角色、间距、圆角、排版与效果。
  • audit-input:为 ux-audit-skill 或 design-critic-skill 收集足够的 Figma 证据。
  • handoff:为实现人员准备上下文。

工作流程

  1. 确认输入类型:Figma URL、选中节点、文件 key、截图/导出,或已连接的 MCP 选择。
  2. 应用 ../../shared/privacy-policy.md。
  3. 若需要调用 use_figma,先调用已安装的 figma:figma-use 技能。
  4. 只读取所需的节点、变量、组件、样式与资源。除非用户要求做库/系统级工作,避免大范围扫描文件。
  5. 产出带证据标签的结构化上下文简报,区分 Figma 直接元数据与视觉推断。
  6. 若 MCP 访问不可用,则请求导出、截图、节点元数据或手动 Figma 细节作为回退方案。

输出形式 使用 assets/context-brief-template.md 模板。

证据规则

  • Figma 元数据:节点名称、类型、布局字段、变量、样式、组件名称、资源引用。
  • 视觉推断:层级、注意力、密度、可能意图、视觉完成度。
  • 缺失:当前 Figma 上下文中无法获得的任何信息。 不得仅凭 Figma 上下文声称 DOM、运行时行为、无障碍扫描或实现层面的证据。

验证与评估

  • 检查最终简报是否标明证据来源与隐私模式。
  • 检查每一条实现相关结论是否可追溯到 Figma 元数据、视觉推断或明确的缺失上下文说明。
  • 使用 evals/evals.json 进行前向测试,以区分已连接 Figma 上下文与仅截图输入。

资源

  • 当工具可用性不明确时,阅读 $CODEX_SKILLS_DIR/senior-figma-orchestrator/references/figma-mcp-compatibility.md。
  • 报告使用 assets/context-brief-template.md。

限制 该技能为只读,不执行修改操作;无法从 Figma 上下文单独推断 DOM、运行时行为、无障碍扫描或实现证据;当 MCP 访问不可用时需依赖导出、截图或手动提供的细节作为回退。