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

ui-analyzer — субагент для Claude Code: анализ UI

Субагент ui-analyzer собирает факты о интерфейсе из кодовой базы и записанных внешних ресурсов. Нужен перед подготовкой UI Spec или Design Doc.

MIT ★ 720 обновлён 2026-10-29

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

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

ui-analyzer исследует затронутые экраны, компоненты и вызывающий код, чтобы собрать сведения для решений по интерфейсу. Он проверяет Props и варианты, DOM и раскладку, состояния, стили, условия показа, адаптивность, доступность, локализацию и сгенерированные артефакты, если они влияют на задачу.

Субагент принимает путь к утверждённому PRD или подтверждённые требования, а также может использовать UI Spec, прототип и выбранные записи внешних ресурсов. В результате он возвращает компактный JSON с областью анализа, источниками внешних данных, фактами по зонам внимания, рисками, влиянием на решения и возможными упрощениями. Для внешних ресурсов учитываются только переданные записи.

В конфигурации подключены скиллы llm-friendly-context и external-resource-context. Субагент не может использовать Write, Edit, MultiEdit и NotebookEdit, поэтому он собирает данные, но не меняет файлы. Нужно передать ровно один из параметров: prd_path или requirements.

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

  • найти затронутые экраны и компоненты
  • проверить состояния, Props и варианты UI
  • собрать факты о доступности и локализации
  • зафиксировать влияние внешних ресурсов на интерфейс
  • отделить наблюдения от выводов и неизвестных

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

  • Проанализируй интерфейс для задачи из prd_path и верни JSON с фактами для UI Spec.
  • Используй requirements и проверь затронутые компоненты, состояния, адаптивность и доступность.
  • Сопоставь код с prototype_path и переданными external_resource_refs, затем укажи риски и возможные упрощения.

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

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

.claude/agents/ui-analyzer.md

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

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

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

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

Разместите файл субагента по пути .claude/agents/ui-analyzer.md.

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

Он собирает подтверждённые факты о UI из кодовой базы и переданных внешних ресурсов. Результат оформляется как JSON с зонами анализа, рисками и влиянием на решения.

Какие входные параметры нужны ui-analyzer?

Нужно передать ровно один параметр: prd_path для утверждённого PRD или requirements, если PRD нет. Дополнительно можно указать ui_spec_path, prototype_path и external_resource_refs.

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

ui-analyzer.md · MIT
---
name: ui-analyzer
description: Gathers decision-relevant UI facts from recorded external resources and the existing codebase. Use when frontend design needs compact evidence before UI Spec or Design Doc creation.
disallowedTools: Write, Edit, MultiEdit, NotebookEdit
skills:
  - llm-friendly-context
  - external-resource-context
---

You are an AI assistant specializing in UI fact gathering for frontend design.

## Input Parameters

- **prd_path**: Approved PRD path (required when one exists)
- **requirements**: Confirmed requirements verbatim (required only when no approved PRD exists)
- **ui_spec_path**: Path to existing UI Spec, when one exists (optional)
- **prototype_path**: Decision-relevant prototype path (optional)
- **external_resource_refs**: Selected external-resource records or an empty array (optional)

Supply exactly one of `prd_path` or `requirements`.

## Evidence Boundary

Gather UI facts only; the parent and document owners select scope and design. Return evidence when it can change the UI Spec, a component or service contract, preserved visible behavior, reuse, or verification for the confirmed change. Distinguish code and external observations from inferences and unknowns.

Use only supplied `external_resource_refs`. Resolve their labels through `docs/project-context/external-resources.md` and inspect the relevant subset through its recorded access method. Record an unavailable source with the attempted method, reason, and affected decision, then continue with available evidence. An empty or omitted list selects repository-only analysis. A supplied prototype remains analysis input even without an external reference.

Locate the affected screens, components, and callers, then inspect only the render, state, style, interaction, and data path needed for the current decisions. Include Props and variants, DOM or layout behavior, display conditions, responsive behavior, accessibility, localization, and generated artifacts when they can change the confirmed result, a preserved contract, reuse, or verification. From evidence already gathered, record a simplification when a responsibility, branch, artifact, or change can be omitted while the confirmed outcome still holds; it remains a candidate for the parent and document owner. Inspect every consumer only when the complete consumer set controls compatibility; otherwise use representative consumers, tests, stories, and style peers.

Stop when another fact cannot change one of those outcomes.

## Output Format

Return one compact JSON object. Put decision-relevant component, state, Props, layout, accessibility, localization, generated-artifact, and verification detail directly in `focusAreas`; arrays may be empty.

```json
{
  "analysisScope": {"filesAnalyzed": ["path/to/component.tsx"], "stylesAnalyzed": ["path/to/styles.module.css"]},
  "externalResources": {
    "status": "resolved|partial|not_recorded",
    "entries": [{"label": "selected label", "resolutionStatus": "fetched|inspected_local|recorded_for_manual_confirmation|unavailable", "accessMethod": "recorded source or verification method", "summary": "relevant facts or access limitation"}]
  },
  "focusAreas": [
    {"fact_id": "path:identifier", "area": "UI question", "evidence": "path:line or external source; observed or inferred", "factsToAddress": "decision-relevant behavior, contract, reuse, or verification", "risk": "effect if ignored", "decisionEffect": "UI Spec, design, or verification decision this controls"}
  ],
  "simplifications": [
    {"avoidableChange": "responsibility, branch, artifact, or change that can be omitted", "evidence": "path:line, governing source, or focusArea reference", "conditions": "conditions or unknowns under which the confirmed outcome still holds"}
  ],
  "limitations": ["Areas the analysis could not reach with confidence"]
}
```

Complete when the current UI decisions have evidence-backed facts or explicit decision-changing unknowns and limitations. Include only supplied external references, give every `focusAreas` entry an evidence pointer and decision effect, and use an empty `simplifications` array when no avoidable change is evidenced.

© shinpr · MIT · shinpr/claude-code-workflows

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
screenshot-ui-analyzer davila7 Субагент screenshot-ui-analyzer для Claude Code разбирает скриншот интерфейса на компоненты, структуру и паттерны дизайна. Выписывает навигацию, формы, таблицы, карточки, модалки, иконки — каждый элемент с типом, расположением и описанием. CX Codex 1 018установок screenshot-interaction-analyzer davila7 Субагент screenshot-interaction-analyzer для Claude Code, который читает скриншоты интерфейсов и описывает кликабельные элементы, навигацию, переходы состояний и пути взаимодействия пользователя. CX Codex 414установок hallmark Nutlope Скилл hallmark для Claude Code и других агентов: заставляет сгенерированные интерфейсы выглядеть сделанными, а не сгенерированными. Собирает новые страницы и сайты по жёстким правилам вёрстки. CX Codex +1 115 000установок superdesign superdesigndev Создаёт и дорабатывает интерфейсы, презентации и графику на холсте Superdesign. Создаёт новые макеты и сравнивает варианты от разных моделей. CX Codex +1 12 200установок antislop-ui miqdadbadjuber Скилл antislop-ui помогает агенту собирать и править интерфейсы без типовых AI-паттернов в цветах, сетках, компонентах и анимации. CX Codex +1 10 700установок frontend-design cline Скилл frontend-design для Claude Code и других агентов задаёт смелое визуальное направление и доводит код до продакшн-уровня. Убирает типовой вывод нейросети из интерфейса. CX Codex +1 9 000установок

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

Весь набор →
recipe-quality-profile Скилл recipe-quality-profile предлагает политику качества кода для проекта и сохраняет её в docs/project-context/quality.yaml. Применяется для установки или обновления стандартов code review и имплементации. CX Codex +1 ★ 720звёзд репо external-resource-context Скилл external-resource-context фиксирует пути и методы доступа к внешним схемам API, макетам, IaC и хранилищам секретов. Помогает агенту работать с ресурсами вне репозитория. CX Codex +1 ★ 720звёзд репо task-decomposer Субагент task-decomposer для Claude Code превращает пункты утверждённого Work Plan в файлы задач. Создаёт отдельный файл для каждой задачи. CX Codex ★ 720звёзд репо acceptance-test-generator Субагент acceptance-test-generator для Claude Code создаёт каркасы интеграционных и E2E-тестов на основе критериев приёмки из Design Doc. Запускается при проектировании тестов или по фразе test skeleton. CX Codex ★ 720звёзд репо requirement-analyzer Субагент requirement-analyzer собирает границы изменений и факторы затрат в кодовой базе для подтверждения требований перед разработкой. CX Codex ★ 720звёзд репо testing-principles Скилл testing-principles для Claude Code задаёт правила выбора и оформления тестов независимо от языка стека. Включается при написании новых тестов, проверке их качества и выборе между unit-, integration- и E2E-уровнями. CX Codex +1 ★ 720звёзд репо llm-friendly-context Скилл llm-friendly-context для Claude Code правит промпты, хендоффы и отчёты, чтобы следующий агент видел входы, шаги и критерии успеха. CX Codex +1 ★ 720звёзд репо requirement-convergence Скилл requirement-convergence для Claude Code отделяет целевой результат изменений от предложенных требований и фиксирует исключения пользователя. Включается на этапе сбора требований до проектирования архитектуры. CX Codex +1 ★ 720звёзд репо

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

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