В этом материале
AGENTS.md подходит для общих правил, .agents/skills — для отдельных навыков. Старые каталоги поддерживаются, но инструкции не заменяют hooks и права.
Старые примеры OpenHands часто упоминают microagents или скрипты подготовки репозитория. Актуальная документация различает общие инструкции, переносимые skills и исполняемые hooks. Миграция должна сохранять назначение каждой части, а не сводить всё в большой файл с предположением о прежней интерпретации. Разные механизмы могут читать похожий текст в разные моменты работы, иметь разные зависимости и предоставлять разные гарантии применения.
Начните с общих правил репозитория
Руководство General Skills описывает краткие сведения о назначении, подготовке, структуре и проверках. Нужные для обычной работы инструкции размещайте в корневом AGENTS.md. Сверяйте команды с настоящим проектом вместо переноса действий из постороннего учебного примера с другими зависимостями.
Для генерируемого клиента назовите исходную схему и команду проверки. Полезное правило объясняет место изменения и способ проверки человеком. Оно не заменяет актуальность обычной документации репозитория и не должно становиться отдельной исторической копией инструкций, противоречащей действующему README и настройкам CI.
Разместите отдельные навыки по текущей схеме
Обзор Skills рекомендует .agents/skills/<skill-name>/SKILL.md для отдельных Agent Skills. Имя и описание участвуют в обнаружении, а полные инструкции и ресурсы загружаются по необходимости. Постоянные правила и отдельный рабочий процесс имеют разную стоимость занимаемого контекста.
Тот же обзор сохраняет поддержку .openhands/skills/ и .openhands/microagents/. Поэтому нельзя обосновывать перенос заявлением, будто старые каталоги просто перестали работать. Выгода состоит в понятной переносимой структуре и явном поведении загрузки новых материалов, которое следует проверить в выбранном клиенте.
Сопоставьте активацию с областью задачи
Выберите правила для каждой задачи, именованного процесса, ключевого слова или пути файла. Специфичные OpenHands расширения активации не обязаны одинаково трактоваться другим клиентом Agent Skills. Переносимость и детерминированное включение остаются отдельными требованиями, которые нельзя объединять одним обещанием совместимости.
В небольшом репозитории создайте каталоги исходников и документации. Запросите изменение в каждом. Проверьте появление инструкции нужного пути без навязывания несвязанных шагов разработки документационной задаче. Затем просмотрите diff вместо доверия одной фразе модели о том, что навык успешно применён.
Отделите исполняемую подготовку
Руководство настройки репозитория описывает .openhands/setup.sh и hooks. Инструкция установить зависимость не выполняет установку сама. Просьба запускать тесты в skill также не даёт того же принуждения, что настроенный stop hook с определённой реакцией на неуспех.
При обновлении старого pre-commit примера изучите современные hooks и необходимое условие завершения. Сохраните рабочую папку команды и зависимости. Не превращайте исторический фрагмент в новую операцию проекта до понимания поведения в выбранном agent-server процессе и фактического назначения проверяемого условия.
Проверьте новый разговор
Документация рекомендует после изменения файлов начать новую беседу для пересборки каталога навыков. Испытайте нужную задачу и запишите реально доступные инструкции. Используйте относительные пути ресурсов и подтвердите наличие файлов в рабочем пространстве backend, а не только на компьютере автора инструкции.
Права проверяйте независимо. Skill может описывать развёртывание, но не разрешает его, не получает учётные данные и не открывает сеть. Успешная миграция даёт ясно активируемый пакет инструкций с поддерживаемыми ресурсами, а не доказательство принудительного контроля любых действий агента силами текстовых файлов.
Материалы по теме
Воспроизводимый стек инференса: как сохранить результат GPU-пилота, LLM для кода на 12 ГБ VRAM: модель, контекст и запас.