mcpField
F
figma-context-reader

figma-context-reader

github.com/sergekostenchuk设计与 UI3253 次安装18 周前更新
代码仓库

关于 figma-context-reader

figma-context-reader 是只读技能,可将 Figma 输入整理为有证据依据的设计简报,适用于设计审查与实现交接,并区分 Figma 元数据和视觉推断。

主要功能

  1. 01生成画框与页面简报
  2. 02汇总组件与设计令牌
  3. 03为审查收集证据
  4. 04准备实现交接背景
  5. 05标注证据并检查隐私

适用场景

  1. 01总结选定的 Figma 画框
  2. 02记录组件变体与约束
  3. 03为 UX 审查准备证据
  4. 04向实现人员交接设计背景

MCP 相关

可通过已连接的 MCP 选择获取 Figma 背景;若无法访问 MCP,则请求导出文件、截图、节点元数据或手动提供细节。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system --skill figma-context-reader

安装后在 Claude Code 中输入/figma-context-reader确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
assets/
context-brief-template.md
evals/
evals.json

详细介绍

Figma Context Reader

使用此技能将 Figma 上下文转化为有证据支持的设计简报。此技能仅供读取;修改操作请转交给 figma-canvas-editor 或 figma-design-system-sync。

模式

  • frame-brief:总结选定的画框或页面。
  • component-brief:总结组件、变体、属性和约束。
  • token-brief:总结变量、样式、颜色角色、间距、圆角、排版和效果。
  • audit-input:收集足够的 Figma 证据,供 ux-audit-skill 或 design-critic-skill 使用。
  • 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 metadata:节点名称、类型、布局字段、变量、样式、组件名称、资源引用。
  • Visual inference:层级、注意力、密度、可能的意图、视觉精致度。
  • Missing:当前 Figma 上下文中不可用的任何信息。

不要仅凭 Figma 上下文声称掌握 DOM、运行时行为、无障碍扫描或实现证据。

验证与评估

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

资源

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

评论

支持 Markdown