Можно ли просто скопировать регламент в SKILL.md?
Обычно нет. Регламент написан для человека, который знает контекст организации. Навыку нужны явные входы, роли, ветвления, исключения, точки подтверждения и критерии готовности — скрытые знания приходится сделать видимыми.
Скопированный документ часто содержит историю, определения, повторения и ссылки на недоступные системы, но пропускает решения, которые сотрудник принимает по опыту. Agent Skill должен превращать документ в исполнимый маршрут, не выдумывая отсутствующие правила.
Если процесса ещё нет и вы создаёте навык с чистого листа, начните с инструкции как создать первый Agent Skill.
Как понять, что процесс подходит для Agent Skill?
Подходит повторяемая работа с устойчивыми правилами и проверяемым промежуточным результатом. Если каждое решение уникально, зависит от полномочий руководителя или требует физического действия, автоматизируйте только подготовительную часть.
- Есть владелец процесса и актуальная версия документа.
- Входные данные можно перечислить.
- Большинство шагов повторяется.
- Исключения можно классифицировать.
- Качество результата можно проверить до внешнего действия.
Для приоритизации нескольких процессов используйте разбор как выбрать AI-навык для бизнеса.
Что извлечь из регламента до написания skill?
Соберите карту процесса: цель, инициатор, обязательные входы, роли, обычный маршрут, развилки, исключения, запрещённые действия, подтверждения и признаки завершения.
| Элемент | Вопрос владельцу процесса |
|---|---|
| Вход | Без каких данных работа не начинается? |
| Решение | По какому признаку выбирается следующая ветка? |
| Исключение | Когда сотрудник останавливается или эскалирует? |
| Подтверждение | Какое действие нельзя выполнять автоматически? |
| Результат | Что можно объективно проверить в конце? |
Как перенести роли и ответственность?
Не заставляйте skill изображать должность. Разделите подготовку, проверку, решение и внешнее действие. Навык может собрать данные и проект результата, но подтверждение остаётся у человека с нужными полномочиями.
Фразы вроде «согласовать с руководителем» нужно превратить в явную точку остановки: что именно показать, кому передать и какой ответ позволяет продолжить. Если адресат или система неизвестны, навык не должен угадывать.
Как описать ветвления и исключения?
Каждая ветка должна иметь наблюдаемое условие. Для неизвестного случая задайте безопасное поведение: запросить данные, передать владельцу процесса или завершить подготовку без внешнего действия.
- Если вход неполон — перечислить недостающие поля.
- Если правило противоречит актуальной политике — остановиться и показать конфликт.
- Если действие необратимо — подготовить план и запросить подтверждение.
- Если случай не описан — не создавать правило самостоятельно.
Как собрать из карты процесса инструкцию SKILL.md?
- 1. Сформулируйте одну работу
Опишите результат и границу навыка одним предложением.
- 2. Перенесите обязательный маршрут
Оставьте шаги, которые нужны в большинстве запусков.
- 3. Добавьте ветки
Свяжите каждое условие с действием или безопасной остановкой.
- 4. Вынесите справочники
Большие таблицы и политики храните отдельно и укажите, когда их читать.
- 5. Опишите доказательство
Зафиксируйте, что проверяется перед выдачей результата.
Детерминированные проверки можно оформить по схеме самопроверки Agent Skill.
Как проверить навык на реальном процессе?
Возьмите 5–10 обезличенных исторических случаев: обычные, неполные, исключительные и рискованные. Сравните маршрут и результат навыка с решением владельца процесса, не подключая рабочие права на первом прогоне.
- Процент случаев, где skill выбрал правильный маршрут.
- Число пропущенных обязательных шагов.
- Число ложных остановок и опасных продолжений.
- Время человека на проверку результата.
- Повторяемость результата при одинаковом входе.
Метрики пилота и контрольную группу разбираем в статье как оценить эффективность Agent Skill.
Кто должен поддерживать skill после пилота?
Владельцем содержания остаётся владелец процесса, а технический редактор отвечает за форму пакета и тесты. При изменении регламента навык и контрольные примеры обновляются одной версией.
Назначьте дату следующего пересмотра и перечислите события, которые требуют внеплановой проверки: новая система, изменение полномочий, новый тип данных или найденный инцидент. Не называйте skill актуальным, если исходный регламент уже заменён.
Для первого пилота достаточно одного процесса, одного владельца и ограниченного набора обезличенных случаев. Это позволяет проверить ценность до интеграций и выдачи рабочих доступов.