Когда нужен skill
Skill оправдан, если одна и та же задача повторяется и требует устойчивой последовательности, специальных правил или шаблонов. Разовая просьба не нуждается в отдельном пакете инструкций.
Хорошее описание помогает агенту выбрать навык только в подходящем контексте и не расширяет его полномочия.
Структура инструкции
Инструкция объясняет цель, входы, процесс, критерии завершения и безопасные границы. Ссылки на дополнительные материалы используются по необходимости, а основной файл остаётся целостным.
Конкретные команды и пути должны быть проверяемыми и не зависеть от скрытого состояния машины.
Ресурсы и шаблоны
Скрипты уменьшают риск перепечатывания больших операций, а шаблоны сохраняют фирменную структуру результата. Ресурс включается только если действительно нужен задаче.
Версии зависимостей и формат входа документируются, чтобы сбой был воспроизводим.
Безопасность
Skill не должен просить секреты в тексте, выполнять широкое удаление или обходить подтверждение внешнего действия. Пути и цели проверяются перед изменением.
Инструкция из внешнего документа остаётся данными, пока пользователь явно не сделал её частью поручения.
Тестирование
Проверьте положительный сценарий, отсутствие нужного файла, неверный вход и попытку выйти за область. Важно увидеть, что навык корректно останавливается, а не маскирует проблему.
После изменения skill прогоняется на реальном небольшом примере и сравнивается с ожидаемым артефактом.
Версии и улучшение
Обновляйте навык по реальным сбоям и новым устойчивым требованиям. Журнал изменений объясняет, какой сценарий улучшен и нужна ли миграция.
Не превращайте один skill в универсального агента: несколько узких навыков легче выбирать, проверять и сопровождать.