Когда разработчики используют терминальных кодинг-агентов вроде Claude Code, Codex или Cursor, стандартный подход заключается в отправке одного общего промпта. Модель пытается одновременно проектировать архитектуру, писать логику компонентов, исправлять ошибки компилятора и проверять безопасность. В результате контекстное окно быстро забивается посторонней информацией, тесты пропускаются, а агент начинает ходить кругами при возникновении ошибок сборки.
Репозиторий ECC (Everything Claude Code) от Affaan Mustafa решает эту задачу через декомпозицию. Это открытая библиотека из 68 специализированных субагентов и 293 модульных скилов, оформленных по открытому стандарту Agent Skills. Вместо одной универсальной модели работа разделяется между узкими ролями: планировщиком, тестировщиком, ревьюером и специалистом по безопасности.
Каталог субагентов: разделение задач между моделями
Каждый агент в ECC описан отдельным файлом с собственной системной ролью, набором разрешенных инструментов и моделью:
| Субагент | Роль и специализация | Инструменты | Рекомендуемая модель |
|---|---|---|---|
planner |
Планирование реализации сложных фич, декомпозиция задачи и анализ зависимостей перед написанием кода | Read, Grep, Glob | Claude Opus |
architect |
Проектирование системной архитектуры, масштабируемость и фиксация технических решений | Read, Grep, Glob | Claude Opus |
tdd-guide |
Ведение разработки по методологии TDD: сначала падающие тесты, затем минимальный код и рефакторинг | Read, Write, Edit, Bash, Grep | Claude Sonnet |
code-reviewer |
Анализ написанного кода: поиск регрессий, проверка качества и соответствия соглашениям проекта | Read, Grep, Glob, Bash | Claude Sonnet |
security-reviewer |
Аудит на уязвимости OWASP, утечки ключей и токенов, SSRF, инъекции и небезопасную криптографию | Read, Grep, Glob, Bash | Claude Sonnet |
build-error-resolver |
Точечное устранение ошибок сборки и типизации (TypeScript/компиляторы) с минимальным диффом без переписывания архитектуры | Read, Write, Edit, Bash, Grep, Glob | Claude Sonnet |
Библиотека скилов: 293 готовых воркфлоу
В отличие от правил, которые постоянно висят в системном промпте, скилы (Skills) загружаются моделью строго по необходимости:
- Формат Agent Skills: каждый скил представляет собой структурированную инструкцию в формате Markdown (
SKILL.md) с описанием триггеров запуска и шагов выполнения. - Примеры прикладных скилов:
api-design— стандарты проектирования REST и gRPC API;database-migrations— безопасное создание и накат миграций баз данных;benchmark-optimization-loop— запуск и профилирование бенчмарков производительности;accessibility— проверка интерфейсов на соответствие стандартам WCAG;continuous-learning— фиксация выводов сессии для повторного использования.
- Экономия контекста: агент обращается к конкретному скилу только тогда, когда разработчик ставит соответствующую подзадачу, не расходуя токены на нерелевантные инструкции.
Языковые правила и стандарты кода (Rules)
Для соблюдения чистоты кодовой базы ECC включает готовые каталоги правил в папке rules/:
common/: универсальные правила (именование переменных, запрет неиспользуемого кода, правила коммитов);- Языковые пакеты: специализированные паттерны для TypeScript, Python, Go, Swift, PHP и ArkTS. Разработчик может подключить только тот набор, на котором написан его стек.
Хуки и защита терминала от деструктивных команд
Одной из частых проблем кодинг-агентов с доступом к Bash является риск случайного удаления файлов или затирания изменений. В ECC встроен механизм перехвата событий инструментов:
- Блокировка опасных команд: хуки перехватывают вызовы в терминале и предотвращают выполнение деструктивных операций (случайный
rm -rf, жесткий сброс веток черезgit checkout --force); - Автоматические проверки: запуск линтеров и валидаторов сразу после редактирования файлов (например, предупреждение об оставленных отладочных вызовах
console.log).
Пошаговое руководство: установка и настройка
ECC распространяется как открытый пакет и поддерживает установку в Claude Code, Codex, Cursor и другие среды разработки.
1. Универсальная установка через npx
npx ecc-universal setupКоманда запускает интерактивный мастер, который:
- Проверяет наличие Node.js (требуется версия 18+), Git и установленного CLI агента;
- Предлагает выбрать целевой редактор (Claude Code, Codex, Cursor);
- Позволяет задать область установки — глобально для пользователя или локально в текущий проект.
2. Установка в Claude Code как плагин
Если вы используете Claude Code, плагин можно подключить напрямую из терминала:
claude plugins install ecc@ecc
# или внутри активной сессии:
/plugin install ecc@ecc3. Проверка и устранение неполадок
Для проверки корректности установленных агентов и скилов доступны встроенные команды:
# Диагностика установленных компонентов
npx ecc-universal doctor
# Восстановление поврежденных файлов и хуков
npx ecc-universal repairИтог
ECC — это масштабная база готовых субагентов и скилов для кодинг-агентов. Репозиторий избавляет от необходимости вручную настраивать промпты для разных стадий разработки: достаточно подключить готовые роли планировщика, TDD-гида и ревьюера, чтобы агент работал последовательно и предсказуемо.
