Руководство по запуску Agency Agents: превратите Claude Code в «команду мечты» с 100+ ролями AI-экспертов

Мы все знаем: написание prompt — это ремесло. Один и тот же Claude-модель, и то, что получится при запросе «напиши React-компонент», будет несопоставимо по качеству с тем, что вы получите при запросе «с позиции опытного фронтенд-инженера, соблюдая спецификацию WCAG 2.1 AA, напиши доступную виртуализированную таблицу на TypeScript + React 18».

Agency Agents как раз создан, чтобы устранить эту проблему: он заранее расписывает 16 отделов и 100+ ролей AI-экспертов (Frontend Developer, Backend Architect, Security Auditor, Reddit Community Ninja…): роли, процессы, артефакты и метрики — всё уже срежиссировано. Вам остаётся только активировать нужную роль, и AI автоматически переходит в «профессиональный режим».

Ещё удобнее то, что в репозитории уже есть convert.sh и install.sh: они позволяют за один проход синхронизировать один и тот же набор определений ролей с Claude Code, OpenClaw, Cursor, OpenCode, Codex, Gemini CLI и ещё 10+ инструментов — не нужно поддерживать по несколько разных конфигураций.

В этой статье мы вместе с нуля запустим всё это и покажем, как в OpenClaw активировать роль и выполнить реальную задачу.

Обзор проекта

msitarzewski/agency-agents появился из обсуждения в Reddit: «Если бы вы могли нанять команду AI-сотрудников, какие должности вы бы выбрали?» После нескольких месяцев итераций проект превратился в довольно полный каталог ролей AI-агентов:

• 16 отделов: engineering, design, marketing, finance, security, sales, testing… — охватывает почти все позиции, которые обычно нужны софтверной компании
• 100+ ролей: от Frontend Developer и Backend Architect до Whimsy Injector и Reality Checker — роли с «температурой персонажа»
• Измеримые артефакты: у каждой роли есть success metrics, deliverables и critical rules — это не абстрактные prompt’ы
• Поддержка множества инструментов: один и тот же Markdown-исходник можно конвертировать в формат Claude Code subagent, OpenClaw workspace, Cursor rule, OpenCode agent, Codex TOML и т. п.

Главное отличие от обычных шаблонов prompt в том, что здесь у каждой роли есть полноценная персона (тон, стиль, механизмы памяти) + бизнес-процессы (mission / workflow / deliverables). По сути, это ближе к «описанию должности».

Сложность / Время / Результат

• Сложность: ⭐⭐ (нужны только команды в командной строке, никакого порога по коду)
• Время: 15–30 минут (первая установка + активация роли + выполнение реальной задачи)
• Результат: превратить Claude Code / OpenClaw в многоролевую AI-команду «по требованию» и надолго сохранить стабильный профессиональный образ персонажей

Портрет целевой аудитории

• Разработчики, которые хотят повышать продуктивность с помощью AI, но не любят возиться с написанием prompt’ов
• Инженеры фронтенда/бэкенда/фуллстека/безопасности/тестирования с опытом 1–5 лет
• Те, кто уже практикует AI-инструменты для разработки (Claude Code, Cursor, OpenClaw, Codex и т. д.)
• Технические лиды, которые хотят внедрить в команде «правила AI-коллаборации»

Ключевые зависимости и окружение

Полное дерево структуры проекта

agency-agents/
├── academic/                       # научные направления
├── design/                         # UI/UX-дизайн
├── engineering/                    # разработка (самый большой отдел, 30+ ролей)
├── finance/                        # финансы
├── game-development/               # разработка игр
├── gis/                            # геоинформатика
├── marketing/                      # маркетинг
├── paid-media/                     # платные размещения
├── product/                        # продукт
├── project-management/           # управление проектами
├── sales/                          # продажи
├── security/                       # безопасность
├── spatial-computing/            # пространственные вычисления
├── specialized/                   # специализированные эксперты
├── strategy/                       # стратегия
├── support/                        # клиентская поддержка
├── testing/                        # тестирование
├── integrations/                   # интеграционные артефакты
│   ├── openclaw/                   # OpenClaw workspace (SOUL.md + AGENTS.md + IDENTITY.md)
│   ├── opencode/                  # OpenCode agent (.md + YAML frontmatter)
│   ├── claude-code/               # Claude Code subagent
│   ├── cursor/                    # Cursor rule (.mdc)
│   ├── codex/                     # Codex custom agent (TOML)
│   ├── gemini-cli/                # Gemini CLI subagent
│   ├── github-copilot/           # GitHub Copilot
│   ├── aider/                     # Aider CONVENTIONS.md
│   ├── windsurf/                  # Windsurf .windsurfrules
│   ├── kimi/                      # Kimi Code CLI
│   ├── qwen/                      # Qwen Code SubAgent
│   └── mcp-memory/               # MCP долгосрочная память
├── scripts/
│   ├── convert.sh                  # определение ролей → конвертер форматов инструмента
│   ├── install.sh                  # установка в локальную среду одной командой
│   ├── lib.sh                      # общие функции
│   └── lint-agents.sh              # lint определений ролей
├── README.md
└── CONTRIBUTING.md

Пошаговое руководство

Ниже мы покажем полный процесс на примере OpenClaw. Для остальных инструментов достаточно заменить параметр --tool на соответствующее имя.

Шаг 1: Клонируйте репозиторий

git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents

Если сеть ограничена, сначала сделайте fork на Gitee / на ваш GitHub и уже потом клонируйте:

git clone https://github.com/<your-fork>/agency-agents.git
cd agency-agents

Шаг 2: Посмотрите доступные отделы и роли

install.sh предоставляет очень удобный режим «листинг»:

./scripts/install.sh --list teams

Вы увидите вывод примерно такого вида:

engineering          33 agents
design               12 agents
marketing            18 agents
security              9 agents
testing              11 agents
...

Если нужно установить только некоторые отделы (например, engineering + security), дальше отфильтруйте их с помощью --division.

Шаг 3: Сгенерируйте интеграционные файлы в формате OpenClaw

convert.sh разложит исходный Markdown на ожидаемые OpenClaw файлы: SOUL.md (персона), AGENTS.md (процесс) и IDENTITY.md (идентичность):

./scripts/convert.sh --tool openclaw

После успешного выполнения в каталоге integrations/openclaw/ появится 100+ поддиректорий:

ls integrations/openclaw/ | head -20
# agency-frontend-developer
# agency-backend-architect
# agency-security-auditor
# agency-reddit-community-ninja
# agency-whimsy-injector
# ...

У каждого поддиректория структура такая:

agency-frontend-developer/
├── SOUL.md        # персона роли: идентичность, память, тон, стиль
├── AGENTS.md      # бизнес-процесс: mission, deliverables, workflow
└── IDENTITY.md    # карточка идентичности: emoji + имя + вайб

Шаг 4: Установите всё в OpenClaw одной командой

# Полная установка (около 100+ ролей)
./scripts/install.sh --tool openclaw

# Рекомендация: выбирайте отделы (чтобы не забивать всё сразу)
./scripts/install.sh --tool openclaw --division engineering,security

Скрипт автоматически скопирует workspace в ~/.openclaw/agency-agents/ и зарегистрирует роли в шлюзе OpenClaw.

Шаг 5: Перезапустите gateway OpenClaw, чтобы новые роли подхватились

openclaw gateway restart

Шаг 6: Активируйте в OpenClaw Frontend Developer

openclaw chat --agent agency-frontend-developer

Либо в конфигурационном файле поменяйте агент по умолчанию на agency-frontend-developer, и при каждом запуске OpenClaw вы автоматически входите в эту роль.

Шаг 7: Выполните реальный запрос

Пусть только что активированный Frontend Developer напишет компонент доступной виртуализированной таблицы с прокруткой:

openclaw chat --agent agency-frontend-developer <<'EOF'
Помоги написать компонент DataTable на React 18 + TypeScript, требования:
1. Использовать @tanstack/react-virtual для виртуализации прокрутки
2. Соответствовать WCAG 2.1 AA по доступности
3. Ячейки должны поддерживать кастомный рендер
4. Обработчик клика по строке должен быть настраиваемым
5. Дай полностью готовый код, который можно запустить напрямую
EOF

Вы заметите, что стиль сгенерированного кода очень единообразный — потому что в определении роли «застыли» ограничения вроде «WCAG 2.1 AA», «обёртка memo» и «оптимизация Core Web Vitals». Нам не нужно каждый раз повторять эти требования в prompt.

Шаг 8: Демонстрация в других инструментах (опционально)

Одна и та же роль-конфигурация конвертируется для Cursor тоже одной строкой:

./scripts/convert.sh --tool cursor
./scripts/install.sh --tool cursor --agent frontend-developer,backend-architect

Частые проблемы и способы устранения

Q1: install.sh сообщает permission denied

Обычно это означает, что install.sh не имеет права на выполнение. Для пользователей macOS / Linux:

chmod +x scripts/install.sh scripts/convert.sh scripts/lib.sh
./scripts/install.sh --tool openclaw

Пользователям Windows: если ошибка появляется в Git Bash, проверьте, что репозиторий скачан через git clone (не распаковывайте zip) и запускайте скрипты через Git Bash.

Q2: OpenClaw пишет «agent not found» или «не зарегистрирован»

В 99% случаев причина в том, что после установки ролей вы не перезапустили gateway:

openclaw gateway restart
openclaw agent list | grep frontend-developer
# если увидите вывод — регистрация прошла успешно

Если не помогло, проверьте, что файл действительно существует в каталоге ~/.openclaw/agency-agents/:

ls ~/.openclaw/agency-agents/agency-frontend-developer/
# должны быть SOUL.md  AGENTS.md  IDENTITY.md

Q3: OpenCode после установки показывает только первые 119 ролей

Это известный баг апстрима OpenCode (issue #27988) — во время выполнения регистрируется примерно 119 subagent, а остальные тихо отбрасываются.

Решение: разбейте установку с помощью --division, чтобы общее число ролей было в пределах 119:

./scripts/install.sh --tool opencode --division engineering
./scripts/install.sh --tool opencode --division marketing --out ~/.opencode-extra/

Скрипт при превышении порога сам выдаст warning. Также можно сначала сделать dry-run:

./scripts/install.sh --tool opencode --division engineering --dry-run

Q4: role frontmatter без нужных полей — convert пропускает

convert.sh пропускает исходные файлы, в которых нет поля name. Если вы форкнули роль и видите, что она не появилась в integrations/openclaw/, проверьте:

# 1. Проверьте frontmatter в исходном файле
head -10 engineering/your-custom-agent.md

# 2. Минимум должно быть:
#    ---
#    name: Your Agent Name
#    description: One-line description
#    ---

# 3. Сделайте конвертацию снова
./scripts/convert.sh --tool openclaw

Q5: Ошибка из-за переносов строк в bash-скриптах на Windows

Если вы распаковали скрипты из zip на Windows, возможно, там CRLF-переносы строк: тогда bash может ругаться с \r: command not found:

# Вариант A: используйте git clone вместо скачивания zip
git clone https://github.com/msitarzewski/agency-agents.git

# Вариант B: вручную конвертируйте переносы строк (Git Bash)
dos2unix scripts/*.sh

Q6: Конфликт персон / «переключение контекста»

Если в одной сессии вы сначала активируете Frontend Developer, а затем Security Auditor, может оказаться, что в контексте остался тон предыдущей роли. Это связано с тем, что большинство CLI-инструментов внедряют agent на уровне «system prompt», и при переключении агента история диалога не очищается автоматически.

Решение:

# Перед переключением агента откройте новую сессию
openclaw chat --new-session --agent agency-security-auditor

Или включите в настройках OpenClaw опцию «авто-архивировать старую сессию при переключении агента».

Дополнительные материалы / направления для углубления

1. Кастомизация шаблона ролей

engineering/engineering-frontend-developer.md — отличный пример. Попробуйте сделать fork и изменить, например, engineering-frontend-developer-chinese.md:

---
name: Frontend Engineer (версия на китайском)
description: Фронтенд-инженер, умеющий React/Vue, UI-реализацию и оптимизацию производительности; выводит комментарии на китайском
color: cyan
emoji: 🖥️
vibe: Вывод на китайском, соблюдение front-end норм ByteDance
---

# Frontend Engineer (версия на китайском)

Вы — **frontend engineer**, сосредоточенный на современных веб-технологиях……

## 🧠 Ваши идентичность и память
- Роль: эксперт по современным веб-приложениям и реализации UI
- Характер: внимание к деталям, чувствительность к производительности, пользователь — прежде всего
- Память: помните типовые UI-паттерны и лучшие практики по доступности

Затем запустите ./scripts/convert.sh --tool openclaw — и новая роль появится в integrations/openclaw/.

2. Добавьте роли долгосрочную память с помощью MCP-Memory

В каталоге integrations/mcp-memory/ есть набор конфигураций MCP memory server. После активации роли смогут сохранять предпочтения между сессиями (например, «эта команда предпочитает pnpm вместо npm»). Как настроить — смотрите mcp-memory/README.md в репозитории.

3. Рабочий процесс с коллаборацией нескольких агентных ролей

Одна роль уже очень мощная, но ещё интереснее — выстроить их в цепочку взаимодействия. Например:

Запрос → [Product Manager] разбивает задачи
     → [Frontend Developer] + [Backend Architect] выполняют параллельно
     → [Code Reviewer] автоматически проверяет
     → [QA Test Engineer] прогоняет тесты
     → [Technical Writer] генерирует описание PR

В OpenClaw встроена функция «workflow», позволяющая соединять эти роли — подробности см. в официальной документации OpenClaw.

4. Снижение стоимости вызовов

Как говорилось выше: за экспертными ролями Agency Agents стоят топовые модели, и при длительной работе затраты могут быть существенными. Если вы хотите запускать те же модели по официальной полуденной цене, просто подключите Defapi (в разделе «Ключевые зависимости» выше есть подробное описание) — без изменений кода.

---

Эта статья написана на основе msitarzewski/agency-agents текущей ветки main (commit на дату 2026-06-13). Дальше в репозитории могут появиться новые отделы или измениться интерфейсы скриптов. Перед началом работ рекомендуется сделать git pull, чтобы синхронизировать актуальную версию.