Агентские скиллы (RU)
Инженерные скиллы для AI-агентов, которые пишут код. Перевод на русский.
Скиллы описывают, как работают сеньоры: порядок действий, пороги качества, практики. Они записаны так, чтобы агент следовал им на каждой фазе разработки.
Это русская адаптация проекта addyosmani/agent-skills (MIT, © 2025 Addy Osmani). Оригинальная лицензия сохранена без изменений, происхождение зафиксировано в NOTICE.md. Если читаете по-английски — идите в оригинал, он первоисточник.
ОПРЕДЕЛЕНИЕ ПЛАН РЕАЛИЗАЦИЯ ПРОВЕРКА РЕВЬЮ РЕЛИЗ
┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐
│ Идея │ ─▶ │ Спека│ ─▶ │ Код │ ─▶ │ Тест │ ─▶ │ Ворота│ ─▶ │ Прод │
│ │ │ PRD │ │ │ │Отладка│ │качества│ │ │
└──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘
/spec /plan /build /test /review /ship
Проверено на реальном примере
Я прогнал скиллы из этого репозитория на настоящем проекте: по циклу /spec → /plan → /build → /test → /review → /ship собрал и выложил работающий сервис.
Демо: claude.product1c.ru — «Навигатор по скиллам»: поиск и фильтрация по всем 24 скиллам, страницы отдельных скиллов, конструктор своего набора с генерацией команды установки.
Исходники демо и журнал прогона лежат в examples/skills-navigator/. Там же — что именно поймал каждый скилл: какие тесты упали первыми, что нашло ревью, что заблокировало выкатку.
Команды
8 слэш-команд, по одной на этап разработки. Каждая сама включает нужные скиллы.
| Что вы делаете | Команда | Ключевой принцип |
|---|
| Определяете, что строить | /spec | Спека до кода |
| Планируете, как строить | /plan | Мелкие атомарные задачи |
| Строите инкрементально | /build | По одному срезу за раз |
| Доказываете работоспособность | /test | Тесты — это доказательство |
| Ревьюите перед вливанием | /review | Улучшать здоровье кода |
| Аудируете производительность | /webperf | Измерь, прежде чем оптимизировать |
| Упрощаете код | /code-simplify | Ясность важнее изобретательности |
| Выкатываете в продакшн | /ship | Быстрее — значит безопаснее |
Если спека уже есть, /build auto составит план и реализует все задачи за один заход: вы одобряете план один раз, дальше агент работает сам. Человек не участвует между задачами, но проверки остаются: каждая задача проходит тесты и получает отдельный коммит, а на сбоях и рискованных шагах работа останавливается.
Скиллы также включаются автоматически по контексту: проектируете API — срабатывает api-and-interface-design, делаете интерфейс — frontend-ui-engineering, и так далее.
Быстрый старт
Быстрее всего поставить через открытый skills CLI: одна команда работает для 70+ агентов (Claude Code, Cursor, Codex, Copilot, Cline и другие):
npx skills add Aleksandr-Litvinenko/agent-skills-ru # установить все 24 скилла
npx skills add Aleksandr-Litvinenko/agent-skills-ru --list # посмотреть перед установкой
Или отдельные скиллы:
npx skills add Aleksandr-Litvinenko/agent-skills-ru --skill code-review-and-quality
npx skills add Aleksandr-Litvinenko/agent-skills-ru --skill interview-me
npx skills add Aleksandr-Litvinenko/agent-skills-ru --skill test-driven-development
Ставите один скилл? Установка через npx копирует только skills/<name>/, но не корневой каталог references/. Скилл будет работать, но пути к общим чеклистам окажутся недоступны. Используйте установку всего репозитория, клонируйте его целиком или скопируйте нужный чеклист в каталог references/ внутри установленного скилла.
Нативная установка под конкретный инструмент:
Установка через маркетплейс:
/plugin marketplace add Aleksandr-Litvinenko/agent-skills-ru
/plugin install agent-skills-ru@agent-skills-ru
Ошибки SSH? Маркетплейс клонирует репозитории по SSH. Если ключи SSH на GitHub не настроены, либо добавьте свой ключ, либо укажите полный HTTPS-адрес, чтобы принудить клонирование по HTTPS:
/plugin marketplace add https://github.com/Aleksandr-Litvinenko/agent-skills-ru.git
/plugin install agent-skills-ru@agent-skills-ru
Если /plugin install всё равно падает с [email protected]: Permission denied (publickey) на Windows или macOS, рекомендуемый обходной путь — один раз настроить Git на подмену SSH-адресов GitHub на HTTPS:
git config --global url."https://github.com/".insteadOf [email protected]:
Локально / для разработки:
git clone https://github.com/Aleksandr-Litvinenko/agent-skills-ru.git
claude --plugin-dir /path/to/agent-skills-ru
Положите скиллы в .cursor/skills/ (синхронизируя из agent-skills-ru/skills/), а короткие политики — в .cursor/rules/*.mdc. Не вставляйте скиллы целиком в правила. См. docs/cursor-setup.md.
Устанавливается как нативный плагин со скиллами, субагентами и слэш-командами. См. docs/antigravity-setup.md.
Установка из репозитория:
agy plugin install https://github.com/Aleksandr-Litvinenko/agent-skills-ru.git
Установка из локального клона:
git clone https://github.com/Aleksandr-Litvinenko/agent-skills-ru.git
agy plugin install ./agent-skills-ru
Устанавливается как нативные скиллы для автообнаружения либо добавляется в GEMINI.md для постоянного контекста. См. docs/gemini-cli-setup.md.
Установка из репозитория:
gemini skills install https://github.com/Aleksandr-Litvinenko/agent-skills-ru.git --path skills
Установка из локального клона:
gemini skills install ./agent-skills-ru/skills/
Добавьте содержимое скиллов в конфигурацию правил Windsurf. См. docs/windsurf-setup.md.
Использует исполнение скиллов через AGENTS.md и инструмент skill.
См. docs/opencode-setup.md.
Используйте определения агентов из agents/ как персоны Copilot, а содержимое скиллов — в .github/copilot-instructions.md. См. docs/copilot-setup.md.
Устанавливается как нативный плагин Codex (Codex CLI v0.122+):
codex plugin marketplace add Aleksandr-Litvinenko/agent-skills-ru
codex plugin add agent-skills-ru@agent-skills-ru
Первая команда регистрирует маркетплейс, вторая ставит плагин. Codex читает корневой каталог skills/ напрямую через .codex-plugin/plugin.json. После установки вызывайте скиллы в чате через @ (например, @spec-driven-development). Локальная установка и разбор проблем — см. docs/codex-setup.md.
Устанавливается нативно встроенной командой cmd skills. Command Code клонирует репозиторий, находит все SKILL.md и ставит их в .commandcode/skills/:
cmd skills add Aleksandr-Litvinenko/agent-skills-ru # выбрать скиллы для установки (проект)
cmd skills add Aleksandr-Litvinenko/agent-skills-ru --global # установить для всех проектов (~/.commandcode/skills/)
cmd skills add Aleksandr-Litvinenko/agent-skills-ru -s spec-driven-development # установить конкретный скилл
Установленные скиллы появляются в слэш-меню TUI, например /spec-driven-development. См. docs/commandcode-setup.md.
Скиллы — это обычный Markdown, они работают с любым агентом, принимающим системные промпты или файлы инструкций. См. docs/getting-started.md.
Внедрение
Как раскатывать набор, зависит от кодовой базы. Руководство по внедрению описывает два пути: полный жизненный цикл с первого дня для нового проекта или постепенное внедрение «сначала проверка» для существующей кодовой базы.
Все 24 скилла
Команды выше — это точки входа. В наборе всего 24 скилла: 23 по жизненному циклу плюс мета-скилл using-agent-skills. Каждый скилл — структурированный рабочий процесс с шагами, воротами проверки и таблицами против самооправданий. На любой скилл можно сослаться напрямую.
Мета — определить, какой скилл подходит
| Скилл | Что делает | Когда применять |
|---|
| using-agent-skills | Сопоставляет поступающую работу с нужным рабочим процессом и задаёт общие правила поведения | В начале сессии или когда надо решить, какой скилл применим |
Определение — прояснить, что строить
| Скилл | Что делает | Когда применять |
|---|
| interview-me | Интервью по одному вопросу, пока не станет ясно (на ~95%), чего пользователь хочет на самом деле, а не что, по его мнению, должен хотеть | Запрос недоопределён или пользователь говорит «проинтервьюируй меня» / «допроси меня» |
| idea-refine | Сначала расширяет идею, потом сужает: из размытой мысли получается конкретное предложение | Есть сырая концепция, которую надо раскрыть |
| spec-driven-development | Написать спеку с целями, командами, структурой, стилем кода, тестированием и границами до всякого кода | Начинается новый проект, фича или существенное изменение |
План — разложить на части
| Скилл | Что делает | Когда применять |
|---|
| planning-and-task-breakdown | Разложить спеку на мелкие проверяемые задачи с критериями приёмки и порядком по зависимостям | Есть спека, нужны реализуемые единицы |
Реализация — писать код
| Скилл | Что делает | Когда применять |
|---|
| incremental-implementation | Тонкие вертикальные срезы: реализовал, протестировал, проверил, закоммитил. Фича-флаги, безопасные умолчания, изменения, удобные для отката | Любое изменение, затрагивающее больше одного файла |
| test-driven-development | Red-Green-Refactor, пирамида тестов (80/15/5), размеры тестов, DAMP вместо DRY, правило Бейонсе, тестирование в браузере | Реализуете логику, чините баги или меняете поведение |
| context-engineering | Давать агентам нужную информацию в нужный момент: файлы правил, упаковка контекста, интеграции MCP | Начало сессии, переключение задач или падение качества вывода |
| source-driven-development | Опирать каждое решение по фреймворку на официальную документацию: проверять, ссылаться, помечать непроверенное | Нужен авторитетный код со ссылками на источники для любого фреймворка или библиотеки |
| doubt-driven-development | Состязательное ревью на свежем контексте каждого нетривиального решения по ходу дела: УТВЕРЖДЕНИЕ → ИЗВЛЕЧЕНИЕ → СОМНЕНИЕ → СВЕДЕНИЕ → СТОП, с опциональной эскалацией на другую модель по разрешению пользователя | Высокие ставки (продакшн, безопасность, необратимость), незнакомый код или уверенный вывод дешевле проверить сейчас, чем отлаживать потом |
| frontend-ui-engineering | Архитектура компонентов, дизайн-системы, управление состоянием, адаптивная вёрстка, доступность по WCAG 2.1 AA | Строите или меняете пользовательские интерфейсы |
Проверка — доказать работоспособность
| Скилл | Что делает | Когда применять |
|---|
| browser-testing-with-devtools | Chrome DevTools MCP для живых данных рантайма: осмотр DOM, логи консоли, трассировки сети, профилирование производительности | Строите или отлаживаете что-либо работающее в браузере |
| debugging-and-error-recovery | Сортировка в пять шагов: воспроизвести, локализовать, сократить, починить, поставить страховку. Правило «останови конвейер», безопасные отступления | Падают тесты, ломается сборка или поведение неожиданное |
Ревью — ворота качества перед вливанием
| Скилл | Что делает | Когда применять |
|---|
| code-review-and-quality | Ревью по пяти осям, размер изменений (~100 строк), пометки серьёзности (Мелочь/Необязательно/К сведению), нормы скорости ревью, стратегии разбиения | Перед вливанием любого изменения |
| code-simplification | Забор Честертона, правило 500, снижение сложности при точном сохранении поведения | Код работает, но читать и поддерживать его тяжелее, чем следовало бы |
| security-and-hardening | Предотвращение OWASP Top 10, паттерны аутентификации, управление секретами, аудит зависимостей, трёхуровневая система границ | Работа с пользовательским вводом, авторизацией, хранением данных или внешними интеграциями |
| performance-optimization | Подход «сначала измерь»: цели Core Web Vitals, процессы профилирования, анализ бандла, поиск антипаттернов | Есть требования к производительности или подозрение на регрессии |
Релиз — выкатывать уверенно
| Скилл | Что делает | Когда применять |
|---|
| git-workflow-and-versioning | Разработка вокруг ствола, атомарные коммиты, размер изменений (~100 строк), паттерн «коммит как точка сохранения» | Любое изменение кода (всегда) |
| ci-cd-and-automation | Сдвиг влево, «быстрее значит безопаснее», фича-флаги, конвейеры ворот качества, петли обратной связи по сбоям | Настройка или изменение конвейеров сборки и выкатки |
| deprecation-and-migration | Взгляд «код это обуза», принудительный и рекомендательный вывод из эксплуатации, паттерны миграции, удаление зомби-кода | Удаление старых систем, перевод пользователей или закрытие функциональности |
| documentation-and-adrs | Записи об архитектурных решениях, документация API, стандарты комментариев — документировать почему | Принятие архитектурных решений, изменение API или выпуск функциональности |
| observability-and-instrumentation | Структурное логирование, метрики RED, трассировка OpenTelemetry, алертинг по симптомам — инструментировать по ходу стройки | Добавление телеметрии или выпуск чего-либо в продакшн |
| shipping-and-launch | Предрелизные чеклисты, жизненный цикл фича-флагов, поэтапные выкатки, процедуры отката, настройка мониторинга | Подготовка к выкатке в продакшн |
Персоны агентов
Заранее настроенные персоны-специалисты для точечных ревью:
| Агент | Роль | Взгляд |
|---|
| code-reviewer | Старший staff-инженер | Ревью по пяти осям по критерию «одобрил бы это staff-инженер?» |
| test-engineer | Специалист по качеству | Стратегия тестирования, анализ покрытия, паттерн «Докажи» |
| security-auditor | Инженер по безопасности | Обнаружение уязвимостей, моделирование угроз, оценка по OWASP |
| web-performance-auditor | Инженер по производительности веба | Аудит Core Web Vitals с быстрым/глубоким режимами и правилом честности метрик; запускается через /webperf |
Матрицу принятия решений, правила оркестрации и то, как персоны сочетаются со скиллами и слэш-командами, см. в docs/agents.md.
Справочные чеклисты
Справочный материал, который скиллы подтягивают по необходимости:
| Справочник | Покрывает |
|---|
| definition-of-done.md | Постоянную планку для всего проекта, в противопоставлении критериям приёмки отдельной задачи |
| testing-patterns.md | Структуру тестов, именование, мокирование, примеры React/API/сквозных тестов, антипаттерны (JavaScript/TypeScript) |
| security-checklist.md | Проверки перед коммитом, аутентификацию, валидацию ввода, заголовки, CORS, OWASP Top 10 |
| performance-checklist.md | Цели Core Web Vitals, чеклисты фронтенда и бэкенда, команды измерения |
| accessibility-checklist.md | Навигацию с клавиатуры, скринридеры, визуальный дизайн, ARIA, инструменты тестирования |
| observability-checklist.md | Вопросы дежурного, структурное логирование, метрики RED/USE, трассировку, алертинг по симптомам, предрелизные ворота |
| orchestration-patterns.md | Одобренные паттерны оркестрации нескольких персон, антипаттерны и правило «персоны не вызывают персоны» |
Как устроены скиллы
Каждый скилл следует единой анатомии:
┌───────────────────────────────────────────────────┐
│ SKILL.md │
│ │
│ ┌─ Frontmatter ───────────────────────────────┐ │
│ │ name: имя-в-нижнем-регистре-через-дефис │ │
│ │ description: Ведёт агента через [задачу]. │ │
│ │ Используй, когда… │ │
│ └─────────────────────────────────────────────┘ │
│ Обзор → Что делает этот скилл │
│ Когда применять → Условия срабатывания │
│ Процесс → Пошаговый рабочий процесс │
│ Самооправдания → Отговорки + возражения │
│ Тревожные признаки → Признаки, что что-то не так │
│ Проверка → Требования к доказательствам │
└───────────────────────────────────────────────────┘
Ключевые проектные решения:
- Процесс, а не проза. Скиллы — это рабочие процессы, которым агенты следуют, а не справочники, которые они читают. У каждого есть шаги, контрольные точки и критерии завершения.
- Против самооправданий. В каждом скилле есть таблица типовых отговорок, которыми агенты пропускают шаги («тесты добавлю потом»), с задокументированными контраргументами.
- Проверка не обсуждается. Каждый скилл заканчивается требованиями к доказательствам: зелёные тесты, вывод сборки, данные рантайма. «Вроде правильно» не считается.
- Постепенное раскрытие.
SKILL.md — точка входа. Вспомогательные справочники подгружаются только по необходимости, так агент тратит меньше токенов.
Структура проекта
agent-skills-ru/
├── skills/ # 24 скилла (23 по жизненному циклу + 1 мета)
│ ├── interview-me/ # Определение
│ ├── idea-refine/ # Определение
│ ├── spec-driven-development/ # Определение
│ ├── planning-and-task-breakdown/ # План
│ ├── incremental-implementation/ # Реализация
│ ├── context-engineering/ # Реализация
│ ├── source-driven-development/ # Реализация
│ ├── doubt-driven-development/ # Реализация
│ ├── frontend-ui-engineering/ # Реализация
│ ├── test-driven-development/ # Реализация
│ ├── api-and-interface-design/ # Реализация
│ ├── browser-testing-with-devtools/ # Проверка
│ ├── debugging-and-error-recovery/ # Проверка
│ ├── code-review-and-quality/ # Ревью
│ ├── code-simplification/ # Ревью
│ ├── security-and-hardening/ # Ревью
│ ├── performance-optimization/ # Ревью
│ ├── git-workflow-and-versioning/ # Релиз
│ ├── ci-cd-and-automation/ # Релиз
│ ├── deprecation-and-migration/ # Релиз
│ ├── documentation-and-adrs/ # Релиз
│ ├── observability-and-instrumentation/ # Релиз
│ ├── shipping-and-launch/ # Релиз
│ └── using-agent-skills/ # Мета: как пользоваться набором
├── agents/ # 4 персоны-специалиста
├── references/ # 7 дополнительных чеклистов
├── examples/skills-navigator/ # Демо-сервис, собранный по этим скиллам
├── hooks/ # Хуки жизненного цикла сессии
├── .claude/commands/ # 8 слэш-команд (Claude Code)
├── .gemini/commands/ # 8 слэш-команд (Gemini CLI)
├── commands/ # 8 слэш-команд (Antigravity CLI)
├── plugin.json # Манифест плагина Antigravity
└── docs/ # Руководства по настройке под каждый инструмент
Зачем нужны агентские скиллы
По умолчанию AI-агент идёт кратчайшим путём и пропускает спеки, тесты, ревью безопасности и другие практики, от которых зависит надёжность. Скиллы дают ему пошаговые процессы с той же дисциплиной, что у сеньоров в продакшн-коде.
В каждом скилле записан инженерный опыт: когда писать спеку, что тестировать, как ревьюить и когда выпускать. Скиллы задают конкретные правила, и по этим правилам продакшн-код отличается от прототипа.
В скиллы вшиты практики Google, в том числе из книги Software Engineering at Google и руководства Google по инженерным практикам. Здесь есть закон Хайрама в проектировании API, правило Бейонсе и пирамида тестов в тестировании, размер изменений и нормы скорости ревью в ревью кода, забор Честертона в упрощении, разработка вокруг ствола в работе с git, сдвиг влево и фича-флаги в CI/CD и отдельный скилл вывода из эксплуатации, относящийся к коду как к обузе. Всё это встроено прямо в шаги, которым следуют агенты.
Сравнение с другими наборами
Чем этот набор отличается от Superpowers и скиллов Мэтта Покока, разобрано в docs/comparison.md: как устроены три набора и когда какой брать. Там же ссылка на эксперимент, где их сравнили напрямую.
Как участвовать
Скиллы должны быть конкретными (применимые шаги, а не размытые советы), проверяемыми (ясные критерии завершения с требованиями к доказательствам), обкатанными (основанными на реальных процессах) и минимальными (только то, что нужно, чтобы направить агента).
Спецификацию формата см. в docs/skill-anatomy.md, правила участия — в CONTRIBUTING.md.
Правки перевода приветствуются. Нашли кальку, неточный термин или сломанную ссылку — открывайте issue или пулл-реквест. Изменения в самой методике лучше нести в оригинальный репозиторий: этот форк следует за ним, а не расходится с ним.
Авторы
Оригинальный проект agent-skills создан и поддерживается:
Русская адаптация и сопровождение перевода: @Aleksandr-Litvinenko.
Лицензия
MIT — используйте эти скиллы в своих проектах, командах и инструментах.
Копирайт оригинала: © 2025 Addy Osmani. Файл LICENSE сохранён без изменений; происхождение и перечень изменений зафиксированы в NOTICE.md.
