# humbleagents ![humbleagents](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/assets/humble-agents-hero.png) [English](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/README.md) · [Русский](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/README.ru.md) · [Čeština](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/README.cs.md) · [Français](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/README.fr.md) Плагин с дизайн-агентами для Claude Code и Codex. Помогает разобраться в брифе, выбрать визуальный стиль, собрать дизайн-систему, создать прототип и проверить интерфейс. Также работает в Gemini CLI и Cursor. ## Установка Вам понадобятся Node.js 20 или 22 и npm 10. ```sh npm install --global @humbleteam/humbleagents@next --ignore-scripts ``` Создайте папку для плагина и замените `/path/to/humbleagents` ниже полным путём к ней. Выберите приложения, которыми пользуетесь: ```sh humbleagents install --location "/path/to/humbleagents" --profile core --runtime claude,codex --yes ``` **Claude Code** ```sh claude --plugin-dir "/path/to/humbleagents/runtimes/claude" ``` **Codex CLI** ```sh codex plugin marketplace add "/path/to/humbleagents" codex plugin add humbleagents@humbleagents-local ``` Начните новую сессию в своём проекте. Если в меню команд Codex нет `/humble:*`, выберите навык **humble** и введите команду. Настройка Gemini CLI и Cursor, а также установка из исходников описаны в [руководстве по установке](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/hosts-and-updates.md). ## Что можно делать - **Начать проект.** Превратить заметки и бриф в требования и выбрать направление дизайна. - **Собрать интерфейс.** Выбрать компоновку, определить компоненты и собрать рабочий прототип. - **Проверить работу.** Оценить экраны и пользовательские сценарии перед передачей. - **Создать рекламные креативы.** Разработать концепции, сгенерировать варианты и сравнить их. Агенты используют общие референсы вместе с брифом, решениями и дизайн-системой вашего проекта. ## Команды | Команда | Что делает | | --- | --- | | `/humble:setup` | Подготовить бриф и выбрать направление дизайна | | `/humble:canvas` | Изучить варианты дизайна | | `/humble:design-system` | Определить стили, токены и компоненты | | `/humble:product` | Создать экраны продукта и пользовательские сценарии | | `/humble:review` | Проверить интерфейс | | `/humble:references` | Найти референсы для дизайна | | `/humble:ads` | Создать и оценить рекламные креативы | | `/humble:improve` | Предложить улучшения общей базы знаний | | `/humble:create` | Спланировать проект по шаблону команды | | `/humble:access` | Проверить доступ к проекту | | `/humble:agents` | Посмотреть доступные сценарии работы | | `/humble:doctor` | Проверить установку и подключения | | `/humble:help` | Показать справку | ## Примеры Для [подключённого проекта](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/project-workspaces.md) с именем `bookshop`: ```text /humble:setup project=bookshop -- Составь требования к интернет-магазину книг на основе брифа. /humble:design-system project=bookshop -- Определи типографику, цвета и компоненты для повторного использования. /humble:product project=bookshop -- Создай оформление заказа на основе дизайн-системы проекта. /humble:review project=bookshop -- Проверь оформление заказа и предложи, как исправить основные проблемы с удобством использования. ``` Опишите нужный результат и приложите относящиеся к задаче файлы, экраны или ссылки. ## Подробнее - **Проекты:** у каждого проекта свой репозиторий на GitHub. Установка публичного плагина не даёт доступа к закрытым проектам или права создавать репозитории в организации команды. [Подключение проекта и синхронизация контекста](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/project-workspaces.md). - **Подключения:** используйте Gmail и Granola через MCP в своём приложении. Figma и Mobbin тоже можно подключить при необходимости. [Настройка подключений](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/project-workspaces.md). - **Обновления:** [обновление, откат и изменение способа установки](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/hosts-and-updates.md). Перед обновлением завершите текущую задачу. - **Решение проблем:** запустите `/humble:doctor`. См. [поддерживаемые среды и известные ограничения](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/verification.md). ## Удаление Если вы установили плагин для Claude Code описанным выше способом, запустите Claude без `--plugin-dir`. Для Codex: ```sh codex plugin remove humbleagents@humbleagents-local ``` Затем удалите установленные файлы и CLI: ```sh humbleagents uninstall --location "/path/to/humbleagents" --yes npm uninstall --global @humbleteam/humbleagents ``` Данные проектов хранятся отдельно от плагина. [Подробнее об удалении](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/hosts-and-updates.md#uninstall). ## Участие в разработке Откройте issue или отправьте pull request с изменением по одной задаче. Для предложений по общей базе знаний используйте `/humble:improve`. Не добавляйте данные клиентов, пароли и ключи доступа. При изменении кода установите зависимости и запустите тесты: ```sh npm ci --prefix platform --ignore-scripts npm test --prefix platform ``` [Разработка и выпуск версий](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/docs/publication.md) · [Уведомления о сторонних компонентах](https://cdn.jsdelivr.net/npm/@humbleteam/humbleagents@13.0.0-rc.0/THIRD_PARTY_NOTICES.md)