Перейти к содержанию

Инструменты разработчика

Одна роль в YAML вместо четырёх копий правил

3 мин чтения

Текст написан ИИ-моделью по источникам, на которые ведут ссылки, и сверен с ними второй моделью. Как мы работаем

Всё о теме: Агенты для программирования →
Изображение: github.com

Personetta Эдварда Фрая (Edward Fry) берёт одно описание роли в YAML и превращает его в правила для четырёх агентов: Cursor, GitHub Copilot, Claude Code и Cline. Проект выложен на GitHub 19 августа и распространяется под лицензией MIT.

Автор объясняет, откуда взялась утилита. У каждого ассистента свой формат правил, свои пути к файлам и свои особенности. Поэтому одинаковый «senior Python reviewer» или «C# architect» во всех четырёх инструментах обходится в четыре копии, которые приходится поддерживать вручную. Personetta собирает роль из общих частей и раскладывает результат по местам, которые ожидает каждый инструмент:

  • Cursor: ~/.cursor/rules/
  • Copilot: ~/.copilot/instructions/
  • Claude Code: ~/.claude/rules/
  • Cline: ~/Documents/Cline/Rules/

Персона в Personetta называется рецептом и собирается из трёх слоёв: базовой роли, языка и задачи. В data/base/ лежат базовые роли (инженер, ревьюер, тестировщик и другие), в data/language_specific/ слои под языки и фреймворки. В data/recipes/ описано, какие слои берутся, в каком порядке и с какими переопределениями. Когда два слоя задают одно и то же поле по-разному, решает движок слияния. Стратегии для каждого поля и правила разрешения конфликтов прописаны в data/config/merge-config.yaml, а каждый файл YAML сверяется с JSON-схемами из data/schemas/. Из коробки есть четыре типа задач (design, implement, review, test) для каждого языка, отсюда имена вроде implement-python или review-python.

Конфликты между слоями Personetta разрешает ещё до того, как файл попадёт к агенту. Но в самом агенте результат остаётся текстом. В документации Claude Code файлы CLAUDE.md и автоматическая память названы контекстом, а не принудительной конфигурацией. Если действие нужно запретить при любом решении модели, документация советует хук PreToolUse: он срабатывает перед вызовом инструмента. Так что даже аккуратно собранная персона для Claude Code остаётся всего лишь инструкцией, которую модель учитывает, но выполнять не обязана.

Генератор в src/generator/ загружает рецепт, проверяет, собирает и пропускает через отдельный форматтер для каждого инструмента. На выходе три файла на инструмент: постоянно включённая базовая часть, индекс-маршрутизатор со списком всех персон и полный текст активного рецепта. Рядом лежит локальный кэш. Рецепты генерируются заранее и кэшируются, поэтому при смене персоны ничего не пересобирается. Активную персону можно выбрать для каждого инструмента отдельно.

Ставится Personetta через pip install personetta или, если CLI нужен в изолированном окружении, через pipx install personetta. Нужен Python 3.11 или новее. В каталоге scripts/ лежат вспомогательные скрипты, которые настраивают PATH и проверяют установку: Setup-Personetta.ps1 для Windows и install-personetta.sh для Linux и macOS.

Набор команд небольшой:

  • personetta install '*' --format <tool> ставит все рецепты для инструмента; поддерживаются маски вроде 'test-*' или '*python*';
  • personetta list показывает доступные роли и рецепты;
  • personetta set-active <recipe> --format <tool> переключает активную персону, а personetta current показывает, какая включена сейчас;
  • personetta recipe <name> --format <tool> печатает один собранный рецепт;
  • personetta validate проверяет весь YAML по схемам;
  • personetta verify проверяет установку: версию, PATH и данные рецептов;
  • personetta remove '<pattern>' --format <tool> удаляет установленные рецепты.

Значение --format выбирается из четырёх: cursor, copilot, claude или cline. Для создания и настройки собственных рецептов в документации есть отдельное руководство, Recipe Guide. Там же описаны архитектура, концепции композиции (со схемами) и типичные проблемы.

Под репозиторием 1 641 проходящий тест: модульные, интеграционные и отдельный набор на качество кода. Ограничения проверяются прямо в pytest: цикломатическая сложность не выше 10, функция не длиннее 25 строк, файл не длиннее 400 строк, плюс лимиты на число методов и импортов и проверка соглашений рабочего пространства. Отдельные тесты собирают настоящий wheel и проверяют, что в него попал каждый рецепт. Код проходит линтер ruff и проверку типов mypy, CI запускается на каждый push.

Демо в README занимает пять шагов: установить пакет, вызвать personetta list, поставить все рецепты через personetta install '*' --format claude, включить implement-python командой set-active и прогнать personetta verify. Проверить результат автор предлагает прямо в агенте: спросить «What role are you playing?», и тот опишет активную персону. Для смены роли хватает одной команды: personetta set-active review-python --format claude.

Пока никто не написал. Будьте первым.

Присоединяйтесь к разговору

Войдите, чтобы оставить комментарий. Он появится после модерации.