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:为实现人员准备上下文。
工作流程
- 确认输入类型:Figma URL、选中节点、文件 key、截图/导出,或已连接的 MCP 选择。
- 应用 ../../shared/privacy-policy.md。
- 若需要调用 use_figma,先调用已安装的 figma:figma-use 技能。
- 只读取所需的节点、变量、组件、样式与资源。除非用户要求做库/系统级工作,避免大范围扫描文件。
- 产出带证据标签的结构化上下文简报,区分 Figma 直接元数据与视觉推断。
- 若 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 访问不可用时需依赖导出、截图或手动提供的细节作为回退。