# Multica Platform Figma

> Figma 读：从文件 URL 拉取页面/画板/组件/样式元数据与设计摘要。平台 skill，供 Tester T1、Designer 下游消费。

- Skill: `it235/multica-platform-figma-2` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add it235/multica-platform-figma-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/it235/multica-platform-figma-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Design & Media
- Author: it235 (https://skillmd.com/u/it235)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/it235/multica-platform-figma-2

---


# Platform · Figma

## Platform 协作

本 skill 为 **platform 层**；供 `multica-test-t1-design`（fetch_all）、`multica-design-ui-impl`、前端 impl 等按名调用。凭据：`FIGMA_TOKEN`。

## Purpose

Figma **读**能力：从 Issue / 设计链接解析 file key，输出结构化 JSON + 可读文本摘要，供测试设计（UI 测试点）与前端实现引用。

> **跨平台**：`python scripts/fetch_file.py`（Windows / macOS / Linux）。

## Files

```text
multica-platform-figma/
├── SKILL.md
├── .env.example
└── scripts/
    ├── fetch_file.py
    └── requirements.txt
```

## Read

```bash
pip install -r scripts/requirements.txt

python scripts/fetch_file.py --url "https://www.figma.com/design/<KEY>/..." \
  --output data/figma.json \
  --summary data/figma_summary.txt
```

| 参数 | 作用 |
| --- | --- |
| `--url` | Figma file / design / proto URL（必填） |
| `--output` / `-o` | 完整 JSON |
| `--summary` / `-s` | 文本摘要（Agent 可直接读） |

凭据：`FIGMA_TOKEN`（Figma → Settings → Personal Access Tokens）。勿写入 Agent Instructions。

## 与产物 / 阶段 skill 的关系

| 调用方 | 实际调用 |
| --- | --- |
| `multica-test-t1-design` | `fetch_all.py` 编排 → 本 skill `fetch_file.py` |
| `multica-design-ui-impl` | Designer 产出链接；下游通过本 skill 或 Figma UI 读取 |

完整矩阵见 [`docs/platform-collaboration.md`](../../../../../docs/zh_CN/platform-collaboration.md)。

## 为什么有效

Figma REST 与凭据集中在 platform skill；T1 / Designer 只声明「读设计」，不重复 API 细节。