Установка обязательных плагинов: superpowers и ui-ux-pro-max | Учебник AI App Factory

Что вы сможете сделать после изучения

• Проверить, установлены ли плагины superpowers и ui-ux-pro-max
• Установить эти два обязательных плагина вручную (если автоматическая установка не удалась)
• Проверить, правильно ли включены плагины
• Понять, почему эти два плагина являются предварительным условием работы конвейера
• Устранять распространенные проблемы при установке плагинов

Ваша текущая проблема

При запуске конвейера Factory вы можете столкнуться со следующими проблемами:

• Сбой этапа Bootstrap: сообщение «не использован навык superpowers:brainstorm»
• Сбой этапа UI: сообщение «не использован навык ui-ux-pro-max»
• Сбой автоматической установки: ошибки установки плагинов при выполнении factory init
• Конфликт плагинов: уже существует плагин с таким же именем, но неправильная версия
• Проблемы с разрешениями: плагин не был правильно включен после установки

На самом деле, Factory при инициализации автоматически пытается установить эти два плагина, но при сбое вам нужно обработать это вручную.

Когда использовать этот метод

Ручная установка плагинов требуется в следующих случаях:

• Сообщение о сбое установки плагинов при выполнении factory init
• Обнаружено, что на этапах Bootstrap или UI не используются необходимые навыки
• Первое использование Factory, чтобы убедиться, что конвейер работает правильно
• Версия плагина устарела и требует переустановки

Почему нужны эти два плагина

Конвейер Factory зависит от двух ключевых плагинов Claude Code:

Плагин	Назначение	Этап конвейера	Предоставляемые навыки
superpowers	Глубокий анализ идеи продукта	Bootstrap	superpowers:brainstorm - систематизированный мозговой штурм, анализ проблемы, пользователей, ценности и гипотез
ui-ux-pro-max	Генерация профессиональной системы дизайна	UI	ui-ux-pro-max - 67 стилей, 96 палитр, 100 правил отрасли

Обязательное требование

Согласно определению в agents/orchestrator.checkpoint.md, эти два плагина являются обязательными:

• Этап Bootstrap: должен использовать навык superpowers:brainstorm, иначе продукт будет отклонён
• Этап UI: должен использовать навык ui-ux-pro-max, иначе продукт будет отклонён

🎒 Подготовка перед началом

Перед началом убедитесь:

• [ ] Установлен Claude CLI (доступен claude --version)
• [ ] Выполнена инициализация проекта с помощью factory init
• [ ] Настроены разрешения Claude Code (см. Руководство по интеграции Claude Code)
• [ ] Нормальное сетевое подключение (требуется доступ к маркету плагинов GitHub)

Основная идея

Установка плагинов следует четырёхэтапному процессу проверка→добавление маркет→установка→проверка:

1. Проверка: проверить, установлен ли плагин
2. Добавление маркет: добавить репозиторий плагина в маркет плагинов Claude Code
3. Установка: выполнить команду установки
4. Проверка: подтвердить, что плагин включён

Сценарий автоматической установки Factory (cli/scripts/check-and-install-*.js) автоматически выполняет эти шаги, но вам нужно знать ручной метод для обработки сбоев.

Делайте вместе со мной

Шаг 1: Проверка статуса плагина

Зачем Сначала убедитесь, что плагин уже установлен, чтобы избежать повторных операций.

Откройте терминал и выполните в корневом каталоге проекта:

claude plugin list

Вы должны увидеть: список установленных плагинов, если он содержит следующее, значит уже установлено:

✅ superpowers (enabled)
✅ ui-ux-pro-max (enabled)

Если эти два плагина не видны или отображается disabled, продолжайте выполнять следующие шаги.

Автоматическая установка factory init

Команда factory init автоматически выполнит проверку установки плагинов (строки 360-392 в init.js). Если успешно, вы увидите:

📦 Installing superpowers plugin... ✓
📦 Installing ui-ux-pro-max-skill plugin... ✓
✅ Plugins installed!

Шаг 2: Установка плагина superpowers

Зачем На этапе Bootstrap нужно использовать навык superpowers:brainstorm для мозгового штурма.

Добавление в маркет плагинов

claude plugin marketplace add obra/superpowers-marketplace

Вы должны увидеть:

✅ Plugin marketplace added successfully

Сбой добавления маркет

Если появляется сообщение «плагин маркет уже существует», можно игнорировать и продолжать выполнение шагов установки.

Установка плагина

claude plugin install superpowers@superpowers-marketplace

Вы должны увидеть:

✅ Plugin installed successfully

Проверка установки

claude plugin list

Вы должны увидеть: в списке содержится superpowers (enabled).

Шаг 3: Установка плагина ui-ux-pro-max

Зачем На этапе UI нужно использовать навык ui-ux-pro-max для генерации системы дизайна.

Добавление в маркет плагинов

claude plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill

Вы должны увидеть:

✅ Plugin marketplace added successfully

Установка плагина

claude plugin install ui-ux-pro-max@ui-ux-pro-max-skill

Вы должны увидеть:

✅ Plugin installed successfully

Проверка установки

claude plugin list

Вы должны увидеть: в списке содержится ui-ux-pro-max (enabled).

Шаг 4: Проверка, что оба плагина работают нормально

Зачем Убедитесь, что конвейер может нормально вызывать навыки этих двух плагинов.

Проверка superpowers

Выполните в Claude Code:

Пожалуйста, используйте навык superpowers:brainstorm, чтобы帮我 проанализировать следующую идею продукта: [ваша идея]

Вы должны увидеть: Claude начинает использовать навык brainstorm, систематически анализируя проблему, пользователей, ценность и гипотезы.

Проверка ui-ux-pro-max

Выполните в Claude Code:

Пожалуйста, используйте навык ui-ux-pro-max, чтобы разработать цветовую схему для моего приложения

Вы должны увидеть: Claude возвращает профессиональную рекомендацию по цветовому оформлению с множеством вариантов дизайна.

Контрольная точка ✅

После выполнения вышеуказанных шагов подтвердите следующее:

• [ ] Выполнение claude plugin list показывает, что оба плагина помечены как enabled
• [ ] В Claude Code можно вызывать навык superpowers:brainstorm
• [ ] В Claude Code можно вызывать навык ui-ux-pro-max
• [ ] При выполнении factory run больше не появляется сообщение об отсутствии плагина

Предупреждения о проблемах

❌ Плагин установлен, но не включён

Симптом: claude plugin list показывает, что плагин существует, но без отметки enabled.

Решение: повторно выполните команду установки:

claude plugin install <ID плагина>

❌ Разрешение заблокировано

Симптом: сообщение «Permission denied: Skill(superpowers:brainstorming)»

Причина: в конфигурации разрешений Claude Code не включено разрешение Skill.

Решение: проверьте, содержит ли .claude/settings.local.json следующее:

{
  "permissions": [
    "Skill(superpowers:brainstorming)",
    "Skill(ui-ux-pro-max)"
  ]
}

Полная конфигурация разрешений

Это пример минимальной конфигурации разрешений. Команда init в Factory автоматически сгенерирует полный файл конфигурации разрешений (включая Skill(superpowers:brainstorm) и другие необходимые разрешения), обычно не требует ручного редактирования.

Если нужно повторно сгенерировать конфигурацию разрешений, выполните в корневом каталоге проекта:

factory init --force-permissions

См. Руководство по интеграции Claude Code для повторной генерации конфигурации разрешений.

❌ Сбой добавления маркет

Симптом: claude plugin marketplace add не удаётся, сообщение «not found» или сетевая ошибка.

Решение:

1. Проверьте сетевое подключение
2. Убедитесь, что версия Claude CLI актуальна: npm update -g @anthropic-ai/claude-code
3. Попробуйте установить напрямую: пропустите добавление маркет, выполните claude plugin install <ID плагина>

❌ Конфликт версий плагина

Симптом: установлен плагин с тем же именем, но неправильная версия, что приводит к сбою конвейера.

Решение:

# Удалить старую версию
claude plugin uninstall <имя плагина>

# Переустановить
claude plugin install <ID плагина>

❌ Проблема с путём Windows

Симптом: при выполнении скрипта в Windows появляется сообщение «команда не найдена».

Решение:

Используйте Node.js для прямого запуска скрипта установки:

node cli/scripts/check-and-install-superpowers.js
node cli/scripts/check-and-install-ui-skill.js

Обработка сбоя автоматической установки

Если автоматическая установка при выполнении factory init не удалась, вы можете:

1. Просмотреть сообщение об ошибке: терминал покажет конкретную причину сбоя
2. Установить вручную: вручную установите два плагина по вышеуказанным шагам
3. Перезапустить: factory run проверит статус плагинов, если уже установлены, продолжит конвейер

Не влияет на запуск конвейера

Даже при сбое установки плагинов, factory init всё равно завершит инициализацию. Вы можете вручную установить плагины позже, это не повлияет на последующие операции.

Роль плагинов в конвейере

Этап Bootstrap (требуется superpowers)

• Вызов навыка: superpowers:brainstorm
• Вывод: input/idea.md - структурированный документ идеи продукта
• Контрольная точка: проверить, что Агент явно указал использование этого навыка (orchestrator.checkpoint.md:60-70)

Этап UI (требуется ui-ux-pro-max)

• Вызов навыка: ui-ux-pro-max
• Вывод: artifacts/ui/ui.schema.yaml - UI Schema, содержащая систему дизайна
• Контрольная точка: проверить, что конфигурация системы дизайна получена из этого навыка (orchestrator.checkpoint.md:72-84)

Итог этого урока

• Factory зависит от двух обязательных плагинов: superpowers и ui-ux-pro-max
• factory init автоматически пытается установить, но при сбое нужно обрабатывать вручную
• Процесс установки плагинов: проверка→добавление маркет→установка→проверка
• Убедитесь, что оба плагина находятся в состоянии enabled, и конфигурация разрешений правильная
• Этапы Bootstrap и UI конвейера принудительно проверяют использование этих двух плагинов

Предпросмотр следующего урока

В следующем уроке мы изучим Обзор конвейера из 7 этапов.

Вы узнаете:

• Полный процесс выполнения конвейера
• Ввод, вывод и обязанности каждого этапа
• Как механизм контрольных точек обеспечивает качество
• Как восстановиться с неудачного этапа

---

Приложение: Ссылка на исходный код

Нажмите, чтобы раскрыть расположение исходного кода

Время обновления: 2026-01-29

Функция	Путь к файлу	Номер строки
Скрипт проверки плагина Superpowers	cli/scripts/check-and-install-superpowers.js	1-208
Скрипт проверки плагина UI/UX Pro Max	cli/scripts/check-and-install-ui-skill.js	1-209
Логика автоматической установки плагина	cli/commands/init.js	360-392
Проверка навыка на этапе Bootstrap	agents/orchestrator.checkpoint.md	60-70
Проверка навыка на этапе UI	agents/orchestrator.checkpoint.md	72-84

Ключевые константы:

• PLUGIN_NAME = 'superpowers': имя плагина superpowers
• PLUGIN_ID = 'superpowers@superpowers-marketplace': полный ID superpowers
• PLUGIN_MARKETPLACE = 'obra/superpowers-marketplace': репозиторий маркет плагина
• UI_PLUGIN_NAME = 'ui-ux-pro-max': имя UI плагина
• UI_PLUGIN_ID = 'ui-ux-pro-max@ui-ux-pro-max-skill': полный ID UI плагина
• UI_PLUGIN_MARKETPLACE = 'nextlevelbuilder/ui-ux-pro-max-skill': репозиторий маркет UI плагина

Ключевые функции:

• isPluginInstalled(): проверить, установлен ли плагин (через вывод claude plugin list)
• addToMarketplace(): добавить плагин в маркет (claude plugin marketplace add)
• installPlugin(): установить плагин (claude plugin install)
• verifyPlugin(): проверить, что плагин установлен и включён
• main(): главная функция, выполняет полный процесс проверки→добавление→установка→проверка