# ui-spec-designer

Субагент ui-spec-designer для Claude Code превращает требования к интерфейсу в спецификацию экранов, состояний и компонентов. Запускается при проектировании фронтенда или запросе на разбиение UI на компоненты.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 720 у репозитория
- Автор: shinpr
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/shinpr/claude-code-workflows/tree/HEAD/agents/ui-spec-designer.md
- Обновлён: 2026-11-11
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/ui-spec-designer

## Что делает

Субагент анализирует требования и, если передан прототип, извлекает из его кода структуру экранов, переходы и взаимодействия. Затем он описывает экраны, состояния компонентов, повторное использование существующих компонентов и требования доступности.

Для работы нужны путь к утверждённому PRD или запись согласованных решений, если PRD нет, и JSON-анализ UI. Анализ кодовой базы и путь к прототипу можно передать дополнительно. Субагент читает критерии фронтенда и шаблон UI-спецификации из навыков `ai-development-guide` и `documentation-criteria`, а результат записывает в `docs/ui-spec/{feature-name}-ui-spec.md`. Без обязательного JSON-анализа UI спецификацию по описанному процессу не составить.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/ui-spec-designer.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/ui-spec-designer.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/ui-spec-designer.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/shinpr/claude-code-workflows/tree/HEAD/agents/ui-spec-designer.md

## Когда брать
- разложить требования к интерфейсу по экранам и состояниям
- описать переходы и условия их срабатывания
- зафиксировать повторное использование компонентов
- связать критерии приёмки с элементами прототипа

## Примеры запросов агенту
- Составь спецификацию UI для этой функции по утверждённым требованиям и анализу UI.
- Разбей экраны этого интерфейса на компоненты и опиши состояния.
- Сопоставь прототип с критериями приёмки и подготовь спецификацию UI.

## Похожие
- [ux-designer](https://affpapa.org/nevibecode/skills/ux-designer.md) — скилл · 1900 установок
- [frontend-designer](https://affpapa.org/nevibecode/skills/frontend-designer.md) — скилл · 345 установок
- [gsd-ui-phase](https://affpapa.org/nevibecode/skills/gsd-ui-phase.md) — скилл · 584 установки
- [component-spec](https://affpapa.org/nevibecode/skills/component-spec.md) — скилл · 2500 установок
- [handoff-spec](https://affpapa.org/nevibecode/skills/handoff-spec.md) — скилл · 2500 установок
- [prototype](https://affpapa.org/nevibecode/skills/raphaelsalaja-prototype.md) — скилл · 168 установок

Из того же набора: [shinpr/claude-code-workflows](https://affpapa.org/nevibecode/by/shinpr/claude-code-workflows.md) — 43 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
