Как превратить повторяющуюся задачу в многоразовый навык для вашего ИИ-агента для программирования

Если вы постоянно вставляете один и тот же чек-лист в свой ИИ-агент для программирования — «напиши conventional commit, затем запусти тесты, затем обнови changelog», — вы делаете работу, которую агент мог бы запомнить за вас. Большинство современных агентов позволяют упаковать периодически повторяющуюся процедуру в небольшой многоразовый файл. В Claude Code это называется навыками (skills); этот же файл также обеспечивает работу слэш-команд вроде /deploy. Это руководство проведёт вас через создание такого навыка с нуля, а затем объяснит принципы, которые переносятся на другие инструменты.

Что такое навык

Навык — это папка с единственным файлом SKILL.md внутри. У этого файла две части: YAML-фронтматтер, который сообщает агенту, когда использовать навык, и тело в формате markdown с инструкциями, которым он следует, когда навык запускается. Ключевое преимущество перед тем, чтобы запихивать всё в файл CLAUDE.md (или AGENTS.md), — это прогрессивное раскрытие (progressive disclosure): тело загружается только тогда, когда навык действительно вызывается, поэтому длинный справочный материал почти ничего не стоит, пока он вам не понадобится.

Вы вызываете навык двумя способами: напрямую, набрав /skill-name, или автоматически — агент читает ваш запрос, сопоставляет его с description навыка и загружает его, если он релевантен.

Где располагаются навыки

То, куда вы поместите папку, определяет, кто сможет ею пользоваться. В Claude Code, согласно официальной документации:

• ~/.claude/skills/<name>/SKILL.md — личный, доступен во всех ваших проектах.
• .claude/skills/<name>/SKILL.md — проектный, закоммичен в репозиторий, чтобы у всех в команде была одна и та же команда.

Имя папки становится командой. Папка под названием summarize-changes даёт вам /summarize-changes.

Конкретный пример

Давайте создадим навык, который подытоживает ваши незакоммиченные изменения и помечает всё рискованное перед коммитом. Создайте директорию:

mkdir -p ~/.claude/skills/summarize-changes

Затем сохраните это как ~/.claude/skills/summarize-changes/SKILL.md:

---
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

## Current changes

!`git diff HEAD`

## Instructions

Summarize the changes above in two or three bullet points, then list any
risks you notice such as missing error handling, hardcoded values, or tests
that need updating. If the diff is empty, say there are no uncommitted changes.

Здесь работают две вещи. Во-первых, description написан для агента, а не для вас — он называет триггеры («что изменилось», «нужно сообщение коммита», «проверить их diff»), чтобы агент знал, когда к нему обратиться. Во-вторых, строка !`git diff HEAD` — это динамическое внедрение контекста: Claude Code запускает эту команду и вставляет её вывод в промт до того, как агент прочитает навык. Инструкции приходят с уже встроенным реальным diff'ом, поэтому ответ опирается на ваше реальное рабочее дерево, а не на догадки.

Внесите небольшое изменение в любой файл, запустите агента и попробуйте оба способа — спросите «что я изменил?», чтобы запустить его автоматически, или наберите /summarize-changes, чтобы выполнить его напрямую.

Передача аргументов

Навыки могут принимать входные данные. Заполнитель $ARGUMENTS в теле заменяется тем, что вы наберёте после команды, а индексированные варианты ($0, $1) захватывают конкретные слова. Навык, вызванный как /fix-issue 4821, может напрямую ссылаться на номер задачи, поэтому один файл обрабатывает каждую задачу вместо отдельного файла на каждый тикет.

Пять принципов для устойчивых навыков

Они применимы независимо от того, пишете ли вы навык Claude Code, команду Cursor или — начиная с функции Record & Replay от OpenAI, выпущенной в июне 2026 года, — редактируете автоматизацию, которую агент записал за вас:

1. Пишите описание для модели. Выносите вперёд конкретные триггерные фразы. Расплывчатое описание означает, что агент никогда не загрузит навык автоматически, и вы снова набираете / и вспоминаете имена.
2. Сводите каждый навык к одной задаче. Навыку, который и развёртывает, и запускает миграции, и публикует в Slack, трудно доверять и ещё труднее его отлаживать. Маленькие узкоспециализированные навыки лучше компонуются.
3. Внедряйте живой контекст вместо его описания. Подтянуть реальный diff, результат теста или список файлов лучше, чем говорить агенту «проверь текущее состояние» — это убирает шаг, на котором агент может ошибиться в догадках.
4. Ограничивайте всё, что имеет побочные эффекты. Для навыков, которые развёртывают, мигрируют или удаляют, требуйте явного вызова, а не позволяйте агенту запускать их автоматически. Перед необратимыми действиями вам нужен человек в контуре.
5. Коммитьте командные навыки в репозиторий. Размещение проектных навыков в .claude/skills/ и их фиксация в репозитории означает, что каждый разработчик — и каждый запуск агента в CI — следует одной и той же процедуре. Ваши соглашения перестают жить в голове одного человека.

Когда стоит прибегнуть к навыку

Правило большого пальца: в тот момент, когда вы в третий раз вставляете одни и те же многошаговые инструкции или когда раздел вашего CLAUDE.md превращается из факта в процедуру, переносите это в навык. Вы получаете многоразовую команду, ваш файл контекста остаётся компактным, а инструкции загружаются только тогда, когда они действительно нужны, — что удерживает и вас, и агента сосредоточенными на текущей задаче.