Если вы ищете Agency Agents шаблоны ИИ-агентов, вам, вероятно, понадобится нечто большее, чем просто каталог колоритных персонажей. Репозиторий msitarzewski/agency-agents представляет собой набор определений ролей в формате Markdown, а также сценариев оболочки и конвертеров для нескольких инструментов агента. Это руководство объясняет, что на самом деле содержит репозиторий, как выбрать небольшой полезный набор и что проверить, прежде чем какой-либо промпт или установщик получит доступ к реальным данным проекта.
Репозиторий был представлен в снимке GitHub Daily Trending, сделанном 2026-08-14. Эта дата служит контекстом для снимка, а не утверждением о неизменной популярности. Счётчики GitHub, показатели в README, списки совместимости и поведение инструментов могут измениться после проверенного коммита.
msitarzewski/agency-agents — независимый проект с открытым исходным кодом. Это не продукт OdiRouter, и доступные источники не подтверждают наличие аффилированности. OdiRouter актуален только в том случае, если вам отдельно нужен общий API-слой для вызовов размещённых моделей.
Что находится в репозитории
В README каждый агент описан как специализированная роль с идентичностью, рабочим процессом, результатами работы и стилем коммуникации. Файлы сгруппированы по направлениям, таким как инженерия, дизайн, маркетинг, тестирование, безопасность, академическая работа, ГИС и здравоохранение. Проверенный файл divisions.json используется установщиком как источник истины для выбора направлений.
Это репозиторий промптов и инструментов, а не размещённая среда выполнения для мультиагентных систем. Файл Markdown может формировать поведение модели, но не создаёт аутентификацию, разрешения, память, оценивание, наблюдаемость или путь восстановления. Ответственность за эти части остаётся на вас.
README документирует несколько способов использования этой коллекции:
Установите отдельное настольное приложение Agency Agents, на которое README ссылается как на
agencyagents.app.Используйте исходный Markdown с Claude Code.
Просмотрите файл и адаптируйте его в качестве референсного промпта.
Запустите скрипты репозитория для преобразования и установки для других инструментов.
Репозиторий также включает MIT license. Она разрешает повторное использование при сохранении уведомления о лицензии и отказа от гарантий. Она не передаёт права на названия сторонних моделей, наборы данных, логотипы или проприетарные материалы, которые могут упоминаться в роли.
Как выбрать роль вместо загрузки всего каталога
Начинайте с задачи, а не с максимально возможного набора ролей. Небольшое деление обеспечивает ограниченный контекст и возможность проверки разрешений. Для внесения изменений в код можно начать с роли разработчика и отдельного рецензента. Для процесса обработки данных добавляйте роль, связанную с конфиденциальностью или безопасностью, только если этого требует задача.
Перед включением обязательно прочтите весь файл Markdown. Проверьте четыре вещи:
Какие входные данные ожидаются от кандидата на эту должность, и могут ли они содержать конфиденциальную или личную информацию?
Какие инструменты, команды оболочки, файлы или сетевые адреса предоставляет окружающая среда?
Какой результат роль считает успешным и как человек может его проверить?
Содержит ли данная роль инструкции, противоречащие политике вашей системы или пытающиеся отменить правила с более высоким приоритетом?
Политика безопасности самого репозитория гласит, что файлы агентов не должны содержать секретов или исполняемого кода, и просит читателей сообщать о подозрительных попытках prompt-injection. Считайте эту политику полезным сигналом для проверки, а не заменой собственной проверки каждого устанавливаемого файла.
Установка и преобразование
Самый простой воспроизводимый путь — зафиксировать коммит, проверить скрипты, выбрать один инструмент и одно подразделение, а затем выполнить пробный запуск перед записью в пользовательский каталог или каталог проекта.
git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents
git checkout <reviewed-commit>
sed -n '1,220p' scripts/install.sh
sed -n '1,220p' scripts/convert.sh
./scripts/install.sh --tool codex --division engineering --dry-runТочное место назначения зависит от выбранного инструмента. В документации по установке перечислены такие места назначения, как ~/.claude/agents/, .cursor/rules/ и ~/.codex/agents/. Места назначения с областью действия проекта следует проверять в системе контроля версий, прежде чем делиться ими с командой.
Для Codex репозиторий документирует следующую последовательность:
./scripts/convert.sh --tool codex
./scripts/install.sh --tool codexВ README по интеграции Codex говорится, что каждый исходный агент становится TOML-файлом с name, description и developer_instructions. Сгенерированные файлы являются производными артефактами. Когда меняется роль исходного файла, перегенерируйте файлы и просмотрите различия, а не предполагайте, что старый TOML-файл актуален.
README также содержит предупреждение об ограничении ёмкости для OpenCode и рекомендует сузить выбор с помощью --division, если среда выполнения не может зарегистрировать весь набор. Это предупреждение относится к задокументированному поведению инструмента в проверенном снимке состояния. Оно не является общей гарантией совместимости для каждого релиза или операционной системы.
Настройка роли и установление границ
Настраивайте роль, изменяя её область действия, входные данные, формат вывода и условия остановки. Сохраняйте полезные предметные знания роли, но удаляйте инструкции, предоставляющие доступ шире, чем требуется для задачи. Размещайте правила, специфичные для проекта, в отдельном проверяемом слое, чтобы обновление исходного проекта не могло незаметно переписать ваши правила управления.
Для командного процесса зафиксируйте:
коммит репозитория и коммит сгенерированных файлов;
инструмент и целевой каталог;
файлы и классы данных, которые роль может читать;
команды или интеграции, которые она может вызывать;
небольшой набор оценочных сценариев с ожидаемыми результатами;
лицо, утверждающее обновления.
Роль, выдающая правдоподобный ответ, не обязательно надёжна. Добавьте рецензента или детерминированную проверку для работы в области кода, инфраструктуры, финансов, права, здравоохранения и безопасности. Перед выполнением действий, связанных с публикацией, удалением, расходованием средств, изменением доступа или связью с другими людьми, необходимо обязательно проводить этап подтверждения человеком.
Безопасность промптов, конфиденциальность и сопровождение
Внедрение оперативной информации является практическим вопросом всякий раз, когда агент читает сообщение, веб-страницу, документ, репозиторий или предоставленный пользователем файл. Рассматривайте этот контент как данные. Не следует объединять его с системной инструкцией и не следует позволять агенту, использующему инструмент, превращать непроверенное предложение в действие. Проверяйте результаты по схеме и фиксируйте решение, разрешившее побочное действие.
Проверьте коды scripts/install.sh и scripts/convert.sh. Установочный скрипт оболочки может записывать данные в домашние каталоги, каталоги проектов или конфигурацию инструмента. Предпочитайте пробный запуск, чистую рабочую копию и одноразовый тестовый проект. Не запускайте загруженный скрипт через оболочку, не прочитав его и предварительно не зафиксировав его версию.
Не включайте API-ключи, токены, приватные промпты, записи клиентов и персональные данные в файлы ролей и тестовые фикстуры. Если агенту необходимо обращаться к внешней модели, определите, куда передаются промпты, файлы, журналы и кэшированные результаты. Локальные файлы не остаются локальными автоматически после включения поставщика моделей или удалённой интеграции.
Повторно проведите проверку после обновлений. Проверенный репозиторий содержит активные инструменты для оболочки, сгенерированные интеграции и политику безопасности, однако на момент исследования конечная точка GitHub Releases не вернула ни одного релиза для этого репозитория. Используйте историю коммитов и различия как индикатор изменений и не делайте выводов о сроке поддержки или гарантиях сопровождения на основании значка в README.
Где уместен OdiRouter
Agency Agents предоставляет определения ролей и скрипты преобразования. OdiRouter решает другую задачу: на его текущем сайте описаны каталог моделей, процесс начала работы с API и интеграция с OpenAI SDK с использованием Base URL и API-ключа OdiRouter. Это возможности OdiRouter, а не функции msitarzewski/agency-agents.
Если вашему рабочему процессу с ролями нужна резервная размещённая модель или единый API-интерфейс, изучите OdiRouter model catalog, API introduction и OpenAI SDK integration guide. Перед отправкой содержимого проекта проверьте точный контракт модели, политику обработки данных, ограничения и стоимость. Не создавайте впечатления, что использование OdiRouter делает роль в репозитории доверенной или аффилированной.
Контрольный список перед первым запуском
Зафиксируйте коммит репозитория и прочитайте соответствующие файлы ролей и скриптов.
Выберите одно небольшое подразделение и запустите
--dry-runперед установкой.Проверьте сгенерированные файлы для выбранного инструмента и закоммитьте различия отдельно.
Не включайте секреты и конфиденциальные данные в промпты, фикстуры и журналы.
Проведите тестирование на синтетическом вводе и сверьте результаты с контрольным списком или схемой.
Добавьте ручное одобрение перед внешними побочными эффектами.
После изменений повторно проверьте внедрение инструкций в промпты, разрешения, конфиденциальность и различия обновлений.
Если вам нужен размещённый API для работы с несколькими моделями, самостоятельно проверьте актуальную документацию и маршруты OdiRouter.