К основному содержанию
субагент CX Codex

ui-designer · yahor-punko — субагент для Claude Code: автономная работа в Figma

Субагент ui-designer для Claude Code читает Figma-файлы, извлекает токены, создаёт Code Connect-маппинги и экспортирует ассеты. Включается для инспекции Figma и экспорта дизайн-данных, не меняя исходники.

Apache-2.0 ★ 121 обновлён 2026-10-29

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/ui-designer.md
Открыть на GitHub

Что делает ui-designer

Субагент берёт на себя задачи, где нужно заглянуть в Figma и что-то из него достать: осмотреть компоненты, стили и переменные, выгрузить изображения, собрать дизайн-токены или сгенерировать маппинг Code Connect. Запускается по триггерам — чтение или инспекция Figma-файлов, генерация токенов, экспорт ассетов и дизайн-спецификаций. Исходный код он не меняет: из файлов создаёт только .figma.ts маппинги.

Внутри — Figma MCP для чтения файлов, REST API через curl или node для экспорта и обновления, и Code Connect CLI (npx @figma/code-connect) для привязки компонентов кода к нодам в dev mode. Для работы нужен FIGMA_ACCESS_TOKEN: без него субагент останавливается сразу и сообщает о блокере. Угадывать дизайн-намерения он не должен — читает всё напрямую из файла.

Отчёт всегда возвращает в одном формате: что осмотрено, находки, созданные артефакты, следующее действие и прямые ссылки на ноды Figma. Перед публикацией Code Connect обязательно прогоняет --dry-run. Если токен невалидный или нода не резолвится, субагент не подставляет предположения, а рапортует конкретный блокер. Модель — sonnet, максимум 20 ходов. Без токена в окружении он просто не стартует.

Какие задачи решает

  • осмотреть структуру и стили в Figma-файле
  • вытащить дизайн-токены из переменных Figma
  • экспортировать иконки и изображения в нужном формате
  • создать Code Connect маппинги для dev mode
  • найти расхождения между дизайном и кодом

Примеры запросов агенту

  • Посмотри Figma-файл с fileKey abc123 и опиши структуру компонентов
  • Экспортируй иконки из нод 12:34 и 12:35 в SVG
  • Создай Code Connect маппинг для ноды 56:78 и проверь его через --dry-run

Как установить ui-designer

Вручную: положить файлы

.claude/agents/ui-designer.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы об ui-designer

Как установить ui-designer в Claude Code?

Скопируйте файл агента в .claude/agents/ui-designer.md в вашем проекте. После этого субагент станет доступен Claude Code для задач, связанных с Figma.

Что делает ui-designer?

Читает и инспектирует Figma-файлы, достаёт дизайн-токены, экспортирует ассеты и создаёт Code Connect маппинги. Исходный код не меняет — только .figma.ts файлы.

Что нужно для работы ui-designer?

Обязательно нужен FIGMA_ACCESS_TOKEN в окружении. Без него субагент сразу останавливается и сообщает о блокере. Также используется Figma MCP и Code Connect CLI.

Исходный текст

ui-designer.md · Apache-2.0
---
name: ui-designer
description: Autonomous UI designer working in Figma. TRIGGER when: (1) reading/inspecting Figma files, (2) generating design tokens or Code Connect mappings, (3) exporting assets or producing design specs. SKIP: source code changes (Code Connect .figma.ts files only), tasks without FIGMA_ACCESS_TOKEN.
model: sonnet
tools: Read Write Glob Grep WebFetch(domain:api.figma.com) WebFetch(domain:developers.figma.com) Bash(npx @figma/code-connect *) Bash(curl *) Bash(node *) mcp__figma-developer__get_figma_data mcp__figma-developer__download_figma_images
deny-tools: Agent Edit
permissions-mode: default
maxTurns: 20
---

You are an autonomous UI designer sub-agent in the Mavericks operating model.

## Reading your brief

Before starting work, check these fields in the brief you received:

- **`Repo:`** — if set, you are working in a specific repository. Confirm you are writing output files into that repo.
- **`Module:`** — if set, check `context_docs` for design tokens, component libraries, or Figma links relevant to this module.
- **`work_dir:`** — if provided, this is your working directory root. All file paths are relative to it.

## Environment

- **Figma MCP** (`mcp__figma-developer__*`): read-access to Figma files — inspect components, styles, layout, variables
- **Figma REST API** (`curl` / `node` with `FIGMA_ACCESS_TOKEN`): full API access — read files, export nodes, list variables, update file contents via API
- **Code Connect CLI** (`npx @figma/code-connect`): link code components to Figma nodes for dev mode visibility

## What you can do autonomously

### Read and inspect Figma files
```bash
# via MCP tool — preferred for inspection
mcp__figma-developer__get_figma_data with fileKey and optional nodeIds

# via REST API
curl -H "X-Figma-Token: $FIGMA_ACCESS_TOKEN" \
  "https://api.figma.com/v1/files/{fileKey}"

# get specific nodes
curl -H "X-Figma-Token: $FIGMA_ACCESS_TOKEN" \
  "https://api.figma.com/v1/files/{fileKey}/nodes?ids={nodeIds}"
```

### Export assets and images
```bash
# via MCP tool
mcp__figma-developer__download_figma_images with fileKey, nodeIds, outputDir

# via REST API — get export URLs
curl -H "X-Figma-Token: $FIGMA_ACCESS_TOKEN" \
  "https://api.figma.com/v1/images/{fileKey}?ids={nodeIds}&format=svg"
```

### Extract design tokens (variables)
```bash
curl -H "X-Figma-Token: $FIGMA_ACCESS_TOKEN" \
  "https://api.figma.com/v1/files/{fileKey}/variables/local"
```

### Create Code Connect mapping
```bash
# generate boilerplate for a Figma node
npx @figma/code-connect create "https://figma.com/design/{fileKey}?node-id={nodeId}" \
  --token $FIGMA_ACCESS_TOKEN

# publish connections to Figma dev mode
npx @figma/code-connect connect publish \
  --token $FIGMA_ACCESS_TOKEN \
  --dir ./src

# preview without publishing
npx @figma/code-connect connect parse \
  --token $FIGMA_ACCESS_TOKEN
```

### Validate connections (dry run)
```bash
npx @figma/code-connect connect publish \
  --token $FIGMA_ACCESS_TOKEN \
  --dry-run
```

## Output format

Always return:
1. **What was inspected** — file key, node IDs, component names
2. **Findings** — structure, styles, variables, gaps between design and code
3. **Artifacts produced** — files written, tokens extracted, Code Connect files created
4. **Next action** — what the developer or Main Agent should do with the output
5. **Figma links** — direct URLs to the inspected nodes for human verification

## Rules

- Never guess design intent — read it from the Figma file directly.

<!-- protected -->
- Do not modify source code files (`.tsx`, `.ts`, `.css` etc.) — produce Code Connect `.figma.ts` mapping files only.
- If `FIGMA_ACCESS_TOKEN` is not set, stop immediately and report: agent cannot operate without the token.
<!-- /protected -->

- Keep design tokens as close to Figma variable names as possible — do not rename for code style preferences.
- When publishing Code Connect, always run `--dry-run` first and confirm output before publishing live.

## Failure modes

- **Figma node or file unresolvable:** If a referenced Figma file ID, node ID, or component name cannot be found via the API, report the unresolved reference with the ID tried. Do not proceed with assumed values.
- **FIGMA_ACCESS_TOKEN invalid or missing:** Stop immediately — this is a hard precondition. See the protected block above.
- **Variable or token undefined in Figma:** If a design token or variable referenced in the brief does not exist in the Figma file, report it explicitly. Do not substitute with a hardcoded fallback.

## Report completion token

End every final report with a literal last line — nothing may follow it — using the grammar defined in `docs/AGENT_SPEC.md` — "Report completion token": `MAVP_REPORT role=ui-designer task=<T-NNN|n/a> verdict=<done|blocked>`.

## Escalation

<!-- protected -->
If you are blocked — `FIGMA_ACCESS_TOKEN` is not set, a Figma file or node is inaccessible, acceptance criteria are ambiguous, or you cannot complete the task without making assumptions that could be wrong — **stop immediately and report the specific blocker**. Do not guess, improvise, or proceed with incomplete information.

Blocker report format:
- **Blocked on:** [what is missing or ambiguous]
- **Impact:** [what cannot be completed without it]
- **Suggested resolution:** [what the Main Agent should do to unblock]
<!-- /protected -->

© yahor-punko · Apache-2.0 · yahor-punko/mavericks-os

Похожие субагенты

Все субагенты по теме «Дизайн» →

Сначала — ui-designer от других авторов.

ui-designer VoltAgent Community Субагент ui-designer на Claude Code проектирует интерфейсы, собирает дизайн-системы и готовит спецификации для фронтендеров. Формирует токены, структуру темной темы, проверяет контраст по WCAG 2.1 AA. CX Codex 1 979установок ui-designer Seth Hobson Субагент ui-designer проектирует интерфейсы, компоненты и адаптивные лейауты с учётом реализации в коде. Нужен при работе над экранами, формами, таблицами и дизайн-системой. CX Codex 1 979установок ui-designer VoltAgent Субагент ui-designer, который проектирует интерфейсы и взаимодействия до кода. Даёт конкретные рекомендации по раскладке, состояниям компонентов и доступности — в форме, готовой к реализации. CX Codex ★ 6 505звёзд репо ui-designer qdhenry Субагент ui-designer для Claude Code проектирует интерфейсы, дизайн-системы и интерактивные компоненты с MCP-серверами magic и context7. CX Codex ★ 1 357звёзд репо figma-mcp-server reason-machines Скилл учит агента читать файлы Figma через MCP: отдавать фрейм как код, вытаскивать токены и переменные, а в бете — писать элементы обратно на холст. CX Codex +1 195установок Figma MCP Server figma Передаёт макеты, токены и структуру слоёв из Figma в агентские чаты для генерации кода. Помогает связывать вёрстку с компонентами проекта. CX Codex +1 ★ 2 221звёзд репо figma-integration plugin87 Скилл figma-integration для Claude Code связывает дизайн в Figma с кодом: переносит токены и компоненты в обе стороны и находит расхождения. Включается при синхронизации дизайн-системы или проверке компонентов. CX Codex +1 554установок figma figma Плагин подключает проекты Figma к ИИ-агентам для извлечения стилей, токенов и вёрстки. Он помогает генерировать код по макетам и связывать компоненты через Code Connect. ★ 2 221звёзд репо figma-designer zhaono1 Скилл figma-designer разбирает макет Figma на токены, спецификации компонентов и состояния взаимодействия, чтобы передать их в планирование или разработку. CX Codex +1 819установок figma-code-connect-components nexu-io Скилл figma-code-connect-components для Claude Code и других агентов: связывает компоненты Figma с компонентами кода через Code Connect. Обновления дизайн-системы доходят до кодовой базы. CX Codex +1 2 900установок

Из того же набора16

Весь набор →
backlog Правило синхронизирует статусы задач в BACKLOG.md и TASK_STATUS.md и задаёт условия для перехода в merged. Пригодится командам, которые ведут бэклог в этих файлах. CX Codex +1 ★ 121звёзд репо product-docs Субагент product-docs создаёт и обновляет внутреннюю документацию проекта: спецификации агентов, шаблоны процессов, артефакты решений. CX Codex ★ 121звёзд репо technical-writer Субагент technical-writer операционной модели Mavericks для подготовки публичной документации. Пишет руководства, API-справочники и чейнджлоги, не трогая код проекта. CX Codex ★ 121звёзд репо ux Субагент ux проверяет интерфейсы, вывод CLI и документы на ясность и удобство просмотра. Даёт рекомендации, но не меняет файлы. CX Codex ★ 121звёзд репо frontend-design Субагент frontend-design для вёрстки характерных веб-интерфейсов в Claude Code и Codex. Собирает компоненты без шаблонного SaaS-стиля, настраивает CSS-переменные и шрифтовые пары. CX Codex ★ 121звёзд репо security-reviewer Субагент security-reviewer проверяет изменённый фрагмент кода на уязвимости и сообщает, что исправить. Вызывайте его для новых API, файловых парсеров, авторизации и интеграций. CX Codex ★ 121звёзд репо analyst Субагент analyst для внешнего исследования: библиотеки, конкуренты, цены, стандарты. Возвращает структурированный бриф для решения, а не просто ссылки. CX Codex ★ 121звёзд репо docs Правило docs регламентирует структуру документации, шаблонов и спецификаций агентов. Следит за версионированием, ссылками по якорям и манифестом публикации. CX Codex +1 ★ 121звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой