Чек-листНовое
кодовое словоСеньор
установка Agent Skills и проведим задачу до релиза
Пошаговый процесс разработки с Agent Skills: от требований и спецификации до плана, реализации через тесты, код-ревью и проверки перед релизом. Подходит для Claude Code, Codex и других агентов с поддержкой скиллов.
Содержание8 глав
1. Подготовить инструменты
- Выбрать агента для кода: Claude Code, Codex или другой агент, поддерживающий скиллы. Пакет Agent Skills открыт под лицензией MIT: 24 скилла для этапов разработки и
using-agent-skillsдля выбора подходящего скилла. - Для Claude Code проверить доступ к платному плану или Anthropic Console и доступность сервиса в своей стране. Установка и запуск описаны в документации Claude Code.
- Для установки через skills CLI проверить Node.js командой
node -v; если команды нет, установить Node.js. - Для установки плагина из репозитория проверить наличие Git.
2. Установить пакет выбранным способом
Claude Code: плагин
- Если Claude Code ещё не установлен, выбрать способ из официальной инструкции. Для macOS, Linux и WSL:
curl -fsSL https://claude.ai/install.sh | bash
- Внутри Claude Code добавить маркетплейс и установить плагин Agent Skills:
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
- Если появится запрос на перезагрузку плагинов, выполнить
/reload-plugins. Открыть меню/и найтиspec,plan,build,test,review,ship. Приставкаagent-skills:в названии допустима. - При ошибке SSH
Permission denied (publickey)повторить добавление маркетплейса по HTTPS:
/plugin marketplace add https://github.com/addyosmani/agent-skills.git
/plugin install agent-skills@addy-agent-skills
Если ошибка остаётся, выполнить в обычном терминале настройку Git и повторить установку. Команда меняет глобальную настройку Git:
git config --global url."https://github.com/".insteadOf git@github.com:
Codex: нативный плагин
- Проверить, что установлен Codex CLI версии 0.122 или новее, и выполнить команды из инструкции пакета для Codex:
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills
- Открыть новую сессию Codex. Вызывать нужный скилл через
@, например@spec-driven-development; слэш-команды Claude Code здесь не используются.
Codex, Claude Code или другой агент: skills CLI
- При необходимости сначала посмотреть список скиллов, затем установить пакет через skills CLI:
npx skills add addyosmani/agent-skills --list
npx skills add addyosmani/agent-skills
Установщик предложит выбрать агента. Дополнительные варианты:
npx skills add addyosmani/agent-skills -g -a claude-code
npx skills add addyosmani/agent-skills --skill code-review-and-quality
Первый вариант ставит пакет для Claude Code во все проекты; второй — только один скилл. При установке одного скилла общие чек-листы из корневой папки references/ не копируются.
3. Провести задачу по этапам
- Уточнить идею и требования. Для сырой идеи использовать
interview-me; для спецификации —/specв Claude Code или@spec-driven-developmentв Codex. Зафиксировать цель, адресата, главный результат, стек, ограничения и критерии готовности вSPEC.md. - Один раз задать планку качества проекта, если она нужна:
/constraintsсоздаётCONSTRAINTS.md. - Разбить спецификацию на задачи. В Claude Code вызвать
/plan, в Codex —@planning-and-task-breakdown. Для каждой задачи указать критерий приёмки, проверку и зависимости; сохранитьtasks/plan.mdиtasks/todo.md. - Реализовывать задачи по одной. В Claude Code вызвать
/build: сначала падающий тест, затем минимальный код, все тесты, сборка, коммит и отметка задачи./build autoиспользовать после одобрения плана для последовательного прохождения всего плана; на ошибках и рискованных шагах процесс останавливается. Для Codex выбирать соответствующий скилл@incremental-implementation. - При баге воспроизвести его тестом. В Claude Code использовать
/test; затем исправить баг и прогнать весь набор тестов. Соответствующий скилл пакета —test-driven-development. - Проверить изменения перед запуском.
/review— корректность, читаемость, архитектура, безопасность и производительность;/code-simplify— упрощение без изменения поведения;/webperf— аудит Core Web Vitals для веб-приложения. - Провести выпускную проверку.
/shipвключает тесты, безопасность, производительность, доступность, инфраструктуру, документацию, решение о запуске и план отката. Для Codex соответствующий скилл —@shipping-and-launch. - Для большой работы начинать новый этап в новой сессии. Передавать контекст через
SPEC.mdиtasks/, а не полагаться на историю чата.
4. Готовые промпты для Claude Code
Заменить текст в угловых скобках своими данными. Для Codex заменить слэш-команду вызовом соответствующего скилла через @; конкретные имена скиллов перечислены выше и в репозитории пакета.
Когда идея ещё сырая — interview-me:
Промт 11 строка · 184 знака
interview me. Нужно сделать <что>. Задавай по одному вопросу за раз и к каждому давай свою догадку, пока не станет ясно, кому это нужно, зачем и как определить готовность. Код не пиши.
Спецификация:
Промт 21 строка · 210 знаков
/spec Нужен <продукт> для <кого>. Главный результат: <что пользователь сможет сделать>. Стек: <стек или «предложи сам и объясни выбор»>. Нельзя: <ограничения>. Сохрани SPEC.md и покажи результат до начала кода.
План:
Промт 31 строка · 215 знаков
/plan Разбей SPEC.md на маленькие задачи: у каждой критерии приёмки, проверка и зависимости. Рискованные задачи поставь в начало, после каждых 2-3 задач добавь точку проверки. Кода пока не пиши, сначала покажи план.
Следующая задача:
Промт 41 строка · 170 знаков
/build Возьми следующую задачу из tasks/todo.md. Сначала тест, который падает, потом минимальный код, потом все тесты и сборка. Сделай коммит и отметь задачу выполненной.
Весь одобренный план:
/build auto
Баг и тест:
Промт 51 строка · 143 знака
/test Баг: <что происходит и как повторить>. Сначала напиши тест, который воспроизводит баг и падает, потом почини и прогони весь набор тестов.
Ревью:
Промт 61 строка · 221 знак
/review Проверь последние изменения по 5 осям: корректность, читаемость, архитектура, безопасность, производительность. Каждую находку пометь Critical, Important или Suggestion, укажи файл и строку и предложи исправление.
Подготовка к запуску:
Промт 71 строка · 191 знак
/ship Прогони чек-лист перед запуском для текущих изменений: тесты, безопасность, производительность, доступность, инфраструктура, документация. Дай решение, запускать или нет, и план отката.
Продолжение в новой сессии:
Промт 81 строка · 234 знака
Прочитай SPEC.md, tasks/plan.md и tasks/todo.md, проверь git status и перепроверь то, что изменилось с последнего прогона тестов. Скажи, какая задача следующая и что осталось открытым, и остановись до подтверждения продолжения работы.
5. Проверить типовые сбои
- Команды Claude Code не появились: выполнить
/reload-pluginsили перезапустить Claude Code и снова открыть меню/. -
npxне найден: установить Node.js и открыть новый терминал. - Codex не видит плагин: проверить версию CLI (0.122+) и открыть новую сессию.
- Агент пропускает этап: явно назвать нужный скилл, например
test-driven-development, или вызвать соответствующую команду.
