Home Assistant Лучшие практики

Что делает навык

Набор лучших практик для создания автоматизаций, helpers, скриптов и дашбордов в Home Assistant с акцентом на использование нативных конструкций вместо шаблонов. Определяет порядок действий при работе с UI, YAML-конфигами и проверке версий.

Когда применять

• Создание новых автоматизаций или helpers с нуля
• Рефакторинг существующих конфигураций, затрагивающий entity IDs или имена устройств
• Использование новых функций Home Assistant с учетом версии инстанса
• Настройка элементов управления и дашбордов через UI или YAML

Как работает

1. Проверка: если изменение затрагивает entity IDs, имена или кросс-компонентные ссылки, сначала прочитать и выполнить workflow safe-refactoring.
2. Использование нативных конструкций Home Assistant вместо шаблонов (templates), так как они обходят валидацию и усложняют отладку.
3. Проверка версии инстанса (GET /api/config или Settings → About) перед использованием функций с пометкой версии (например, 2026.5+).
4. Чтение соответствующих файлов Reference Files перед ответом, не загружая их все сразу.
5. Если нет доступа к API, предложить пользователю точный YAML для режима 'Edit in YAML' или поля формы для helper, либо выполнить изменение через браузер после подтверждения.
6. Для YAML-конфигураций: сохранить копию файла, проверить конфигурацию и выполнить reload в Tools (YAML tab) или restart.

Примеры запросов агенту

Что понадобится

• Доступ к веб-интерфейсу Home Assistant (UI) или API
• Редактор файлов (File editor app) или доступ к папке config
• Знание версии Home Assistant (GET /api/config)

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.