# Skills OpenHands: перенос старых инструкций репозитория

Перенос инструкций репозитория OpenHands в AGENTS.md и актуальные каталоги Agent Skills с отдельной проверкой hooks, подготовки среды и прав инструментов.

Автор: Команда Retrivium
Обновлено: 2026-11-03
Канонический URL: https://retrivium.ai/ru/journal/openhands-repository-skills-current-layout/
Language: ru

Старые примеры OpenHands часто упоминают microagents или скрипты подготовки репозитория. Актуальная документация различает общие инструкции, переносимые skills и исполняемые hooks. Миграция должна сохранять назначение каждой части, а не сводить всё в большой файл с предположением о прежней интерпретации. Разные механизмы могут читать похожий текст в разные моменты работы, иметь разные зависимости и предоставлять разные гарантии применения.

## Начните с общих правил репозитория

[Руководство General Skills](https://docs.openhands.dev/overview/skills/repo) описывает краткие сведения о назначении, подготовке, структуре и проверках. Нужные для обычной работы инструкции размещайте в корневом `AGENTS.md`. Сверяйте команды с настоящим проектом вместо переноса действий из постороннего учебного примера с другими зависимостями.

Для генерируемого клиента назовите исходную схему и команду проверки. Полезное правило объясняет место изменения и способ проверки человеком. Оно не заменяет актуальность обычной документации репозитория и не должно становиться отдельной исторической копией инструкций, противоречащей действующему README и настройкам CI.

## Разместите отдельные навыки по текущей схеме

[Обзор Skills](https://docs.openhands.dev/overview/skills) рекомендует `.agents/skills/<skill-name>/SKILL.md` для отдельных Agent Skills. Имя и описание участвуют в обнаружении, а полные инструкции и ресурсы загружаются по необходимости. Постоянные правила и отдельный рабочий процесс имеют разную стоимость занимаемого контекста.

Тот же обзор сохраняет поддержку `.openhands/skills/` и `.openhands/microagents/`. Поэтому нельзя обосновывать перенос заявлением, будто старые каталоги просто перестали работать. Выгода состоит в понятной переносимой структуре и явном поведении загрузки новых материалов, которое следует проверить в выбранном клиенте.

## Сопоставьте активацию с областью задачи

Выберите правила для каждой задачи, именованного процесса, ключевого слова или пути файла. Специфичные OpenHands расширения активации не обязаны одинаково трактоваться другим клиентом Agent Skills. Переносимость и детерминированное включение остаются отдельными требованиями, которые нельзя объединять одним обещанием совместимости.

В небольшом репозитории создайте каталоги исходников и документации. Запросите изменение в каждом. Проверьте появление инструкции нужного пути без навязывания несвязанных шагов разработки документационной задаче. Затем просмотрите diff вместо доверия одной фразе модели о том, что навык успешно применён.

## Отделите исполняемую подготовку

[Руководство настройки репозитория](https://docs.openhands.dev/openhands/usage/customization/repository) описывает `.openhands/setup.sh` и hooks. Инструкция установить зависимость не выполняет установку сама. Просьба запускать тесты в skill также не даёт того же принуждения, что настроенный stop hook с определённой реакцией на неуспех.

При обновлении старого pre-commit примера изучите современные hooks и необходимое условие завершения. Сохраните рабочую папку команды и зависимости. Не превращайте исторический фрагмент в новую операцию проекта до понимания поведения в выбранном agent-server процессе и фактического назначения проверяемого условия.

## Проверьте новый разговор

Документация рекомендует после изменения файлов начать новую беседу для пересборки каталога навыков. Испытайте нужную задачу и запишите реально доступные инструкции. Используйте относительные пути ресурсов и подтвердите наличие файлов в рабочем пространстве backend, а не только на компьютере автора инструкции.

Права проверяйте независимо. Skill может описывать развёртывание, но не разрешает его, не получает учётные данные и не открывает сеть. Успешная миграция даёт ясно активируемый пакет инструкций с поддерживаемыми ресурсами, а не доказательство принудительного контроля любых действий агента силами текстовых файлов.

## Материалы по теме

[Воспроизводимый стек инференса: как сохранить результат GPU-пилота](/ru/journal/software-stack-reproducibility/), [LLM для кода на 12 ГБ VRAM: модель, контекст и запас](/ru/journal/coding-llm-12gb-vram/).