Раздел 04 из 08
Skills и Workflows: научи агента своему делу один раз
Skill — это записанная инструкция, которую агент сам достаёт, когда задача подходит. Объяснила один раз, как разносить транзакции PayEm в חשבשבת — какие FR ставить, как ловить категорию по ключевым словам, что считать аномалией — и больше не диктуешь это заново каждый месяц. Ты пишешь регламент, а не повторяешь его.
Разовый prompt живёт один разговор: закрыла окно — знание ушло. Каждый месяц заново диктуешь правила выгрузки зарплаты или разбора PayEm, и однажды забудешь оговорку про ניכויים — проводка уйдёт кривая. Skill переводит «я каждый раз объясняю» в «есть записанный регламент, агент ему следует».
Что такое skill: рабочая инструкция, которую агент читает сам
Skill = папка, а не один файл
В минимуме это папка с файлом SKILL.md. Рядом по необходимости лежат примеры, шаблоны выгрузки, маленькие скрипты, справочники — реестр FR, список категорий по ключевым словам. Агент видит папку и берёт оттуда то, что нужно под задачу.
По сути
Это рабочая инструкция «как мы это делаем у нас» — документ в папке регламентов, а не разовое поручение. Новый разговор с агентом открывает её и работает по правилам. Знание больше не живёт только у тебя в голове.
description — это триггер, а не описание
Самое важное поле. Это не аннотация для человека, а условие срабатывания: по нему агент решает, есть ли у него подходящая инструкция под запрос. Поэтому пиши не «инструкция про PayEm», а «когда нужно разнести транзакции PayEm по кредитным картам в ERP, проставить FR и определить категорию по ключевым словам». Чем точнее триггер — тем надёжнее агент сам подхватит навык.
Где живут skills
| Где | Путь | Когда использовать |
|---|---|---|
| В конкретном проекте/папке | .claude/skills/<имя>/SKILL.md | Навык нужен только в рабочей папке этого клиента или этой задачи |
| Глобально, для всех проектов | %USERPROFILE%\.claude\skills\<имя>\SKILL.md | Навык универсальный — например, твой общий регламент разбора PayEm |
Минимальный шаблон SKILL.md
---
name: payem-to-erp
description: |
Используй, когда нужно разнести транзакции PayEm
(выгрузка по кредитным картам) в SAP Business One:
проставить корректные FR, определить категорию
расхода по ключевым словам и найти подозрительные
операции для ручной проверки.
---
# Разнос PayEm в ERP
## Что на входе
- CSV-выгрузка из PayEm (дата, сумма, мерчант, описание).
## Правила (реестр)
1. Категория определяется по ключевым словам в описании:
- "Wolt", "Cibus" -> питание сотрудников
- "AWS", "Google Cloud" -> IT-инфраструктура
- "Egged", "Rav-Kav" -> транспорт
2. FR проставляется по таблице соответствия категория -> FR.
3. Сумма без חשבונית -> пометить как требующую документа.
## Аномалии (что считать ошибкой)
- Сумма выше среднего по категории за 3 месяца.
- Дубль: та же сумма + мерчант в тот же день.
- Описание не подошло ни под одно ключевое слово.
## На выходе
- Файл для импорта в SAP B1 + отдельный список
"проверь вручную".
Инженеры Anthropic, которые делали skills, говорят прямо: самая полезная часть инструкции — не общие шаги (их агент и так знает), а раздел про грабли. Сюда складывай каждый реальный косяк, который ловила руками: «вот тут PayEm дублирует строку», «этот мерчант пишется тремя способами». Пополняй по мере того, как находишь новые. Именно этот раздел делает результат точным.
Slash-команды: быстрый ярлык-промпт
Что это
Файл .claude/commands/<имя>.md — сохранённый prompt, который ты вызываешь короткой командой /имя. Имя файла = имя команды. Внутри — текст задачи плюс по желанию небольшой frontmatter.
---
description: Сверка зарплаты с прошлым месяцем
---
Сравни выгрузку зарплаты $ARGUMENTS
с прошлым месяцем и выдели:
- ניכויים, которые изменились
- новых/выбывших сотрудников
- суммы с отклонением больше 10%Вызов: /salary-diff oketz-june.xlsx. $ARGUMENTS подставит то, что допишешь после команды.
Чем отличается от skill
Команду вызываешь ты сама, набирая /имя — горячая клавиша для часто повторяемого промпта.
Skill агент подхватывает сам по полю description, когда задача подходит — и он богаче: целая папка с правилами, шаблонами и скриптами.
Команда — записка-напоминалка, skill — раздел в папке регламентов.
Строка с ! в начале запускает shell-команду и подставляет её вывод (!ls *.csv — показать файлы выгрузки). Строка с @ подставляет содержимое файла (@reestr-fr.md — приложить реестр FR). Так команда работает с реальными данными, а не с абстракцией.
Subagents: узкий специалист на подхвате
Помощник с одной ролью
Subagent — отдельный исполнитель с узкой задачей и своим набором прав, которого основной агент вызывает за вторым мнением. Типичный для тебя пример — «проверяльщик аномалий»: основной агент разнёс зарплату, передал результат субагенту, и тот занят только одним — придирчиво ищет ошибки и отклонения.
Зачем отдельно: у субагента чистый контекст и свежий взгляд — он не «защищает» работу, которую только что сделал основной агент, поэтому ловит замылившееся. Это как отдать готовую ведомость на ревизию другому человеку. Заводятся субагенты как отдельные описания роли в папке агентов проекта — но вручную создавать не обязательно, об этом ниже.
Workflow: связать навыки в один процесс
Отдельные skills — кирпичи. Workflow — описанная словами последовательность шагов под большую задачу: агент идёт по ним по порядку и проверяет себя на каждом. Твоя боль №1 — ровно такой workflow.
Импорт Нормализация Проверка Экспорт
┌────────┐ ┌───────────┐ ┌──────────┐ ┌──────────┐
│ PayEm │ ──▶ │ привести │ ──▶ │ аномалии │ ──▶ │ файл для │
│ .csv │ │ к единому │ │ + ошибки │ │ SAP B1 │
│ │ │ формату │ │ (subagent)│ │ + FR │
└────────┘ └───────────┘ └────┬─────┘ └──────────┘
│
⚠️ стоп: спорные строки
-> тебе на ручную проверку
- Импорт. Агент берёт выгрузку из PayEm/Michpal и читает её.
- Нормализация. Приводит к единому виду: даты, суммы, мерчанты. Здесь подключается skill
payem-to-erp. - Проверка. Прогоняет результат через субагента-«проверяльщика»: аномалии, дубли, строки без חשבונית.
- Развилка. Спорное и подозрительное откладывается отдельным списком — тебе на глаза, а не молча в ERP.
- Экспорт. Чистые строки уходят в формат импорта SAP Business One с корректными FR.
Хороший workflow устроен как сверка: не «сделал всё и показал итог», а «после каждого этапа — проверка, стоп при сомнении». Спорные проводки подписываешь ты. Агент делает рутину, но не принимает рискованные решения молча.
Главное: skills не пишут руками-программистом
Тебе не нужно уметь верстать markdown и frontmatter. Лучший инструмент для создания skill — сам агент. Ты описываешь словами, что должно происходить, он задаёт уточняющие вопросы и собирает папку. Знание — твоё, оформление — его.
Claude, помоги мне сделать skill для моей повторяющейся
задачи. Не пиши его сразу — сначала задай мне вопросы.
Задача: каждый месяц я беру выгрузку транзакций из PayEm
и разношу их в SAP Business One. Нужно проставлять FR,
определять категорию расхода по ключевым словам в описании
и отдельно выписывать подозрительные операции на ручную
проверку.
Расспроси меня про:
- как выглядит выгрузка (колонки, формат);
- мои правила: какое ключевое слово -> какая категория -> какой FR;
- что я считаю аномалией или ошибкой;
- какие грабли уже встречались (дубли, странные мерчанты).
Потом предложи структуру SKILL.md, покажи черновик,
и положи готовый skill в .claude/skills/. Сложные таблицы
правил вынеси в отдельные файлы рядом, чтобы их было
удобно дополнять.Отвечай на вопросы своими словами, на том языке, на котором думаешь о работе — агент переведёт это в skill. Нашла через месяц новый edge-case — просто говоришь: «допиши в раздел аномалий: вот такие строки PayEm дублирует». Ни одна оговорка не теряется.
Что когда использовать: шпаргалка
| Инструмент | Что это | Кто запускает | Когда брать |
|---|---|---|---|
| prompt | Разовое поручение в разговоре | Ты, вручную | Задача единичная, повторять не будешь |
| slash-команда | Сохранённый prompt под /имя |
Ты, набирая /имя |
Один и тот же текст просишь часто — хочешь ярлык |
| skill | Папка с правилами, шаблонами, скриптами | Агент сам, по триггеру | Сложный регламент с нюансами, который агент должен подхватывать автоматически |
| subagent | Узкий специалист со своей ролью | Основной агент, делегируя | Нужен независимый контролёр (проверяльщик аномалий, ревизор) |
| workflow | Цепочка шагов и навыков под большую задачу | Агент по описанию, с проверками | Сквозной процесс: импорт → нормализация → проверка → экспорт |
Skill — это записанное знание. Чтобы он реально дотягивался до PayEm, SAP или файлов на диске, ему нужны руки — MCP и permission, про них отдельная глава. Чтобы навык запускался сам по расписанию (например, каждое 1-е число) — hook и автоматизация. Skill — «что и как делать», следующие главы — «чем и когда».