29 октября Cloudflare обновила работу Agent Skills в Agents SDK. Папку с SKILL.md теперь можно записать в /workspace/.agents/skills/, и агент сможет использовать навык на следующем ходе без новой сборки и развёртывания. На Mentoring.digital объясняем, что меняется для разработчиков собственных агентов.
Навык становится набором обычных файлов
Agent Skills содержат инструкции, справочные материалы и при необходимости скрипты. Агент сначала видит краткий каталог названий и описаний, а полный текст навыка загружает, когда он подходит задаче. Такой подход позволяет отделить специальные процедуры от инструкций, нужных на каждом ходе.
Источником может служить Computer Workspace, бакет R2 или описание в коде. В Think источники возвращаются из getSkills(); файловое хранилище подключается через skills.workspace(this.workspace). Каталог перечитывается перед каждым ходом, поэтому добавление, изменение или удаление файла влияет на следующий шаг агента.
Порядок источников и предупреждения требуют внимания
При совпадении имён побеждает первый источник. Последующие дубли пропускаются с предупреждением в журнале. Это важно, если команда одновременно подключает общую библиотеку из R2 и локальные навыки: одинаковое имя не означает автоматическое объединение содержимого.
Формат SKILL.md проверяется по спецификации Agent Skills. Однако нарушение правила не блокирует загрузку: навык остаётся доступным, а система записывает предупреждение. Для предварительной проверки предусмотрен parseSkill(). Проверка формата сама по себе не подтверждает правильность инструкции или безопасность её выполнения.
Обновление требует проверки старых импортов
Для нового варианта указаны Agents SDK 0.32.0 и Think 0.23.0 или новее. При прямом использовании agents/skills есть несовместимые изменения: удалены импорт agents:skills, модуль agents/skills/compile, SkillRegistry и свойство Think skillWorkspace. Функция runner() перенесена в agents/skills/runner.
Перед обновлением сохраните текущий набор навыков и составьте небольшой сценарий проверки: загрузить навык, прочитать его ресурс, изменить описание и убедиться, что следующий ход получает обновлённый каталог. Отдельно проверьте совпадающие имена и предупреждения. Возможность Agent Skills пока экспериментальная, поэтому версию зависимости и результат проверки стоит фиксировать вместе.
Обсудить хранение файлов, права инструментов и проверку поведения агента можно с наставником по серверной разработке. Начинать удобнее с одной процедуры, результат которой можно сопоставить с исходными данными.
