# ota-deployment-guardian

Скилл ota-deployment-guardian защищает удалённые платы ESP32 и Arduino Uno R4 WiFi от окирпичивания при OTA-обновлениях. Помогает настроить откат прошивки и разобрать сбои сетевых портов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 115 установок · ★ 33 у репозитория
- Автор: wedsamuel1230
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/wedsamuel1230/embedded-engineering-skills/tree/HEAD/skills/ota-deployment-guardian/SKILL.md
- Обновлён: 2026-10-15
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/ota-deployment-guardian

## Что делает

Скилл проверяет прошивки перед удалённой загрузкой по воздуху на ESP32, Nano ESP32 и Arduino Uno R4 WiFi. Он разделяет проблемы доступности сети и обнаружения mDNS-портов в IDE. Если плата пингуется, это ещё не гарантирует успешную прошивку по воздуху.

Ассистент напоминает сохранить обработчик OTA в новом коде скетча, чтобы не потерять удалённый доступ навсегда. Для чистого ESP-IDF предусмотрен разбор слотов приложений, подтверждения загрузки и схем NVS. С платой Uno R4 WiFi учитываются ограничения её сетевого модуля, чья архитектура отличается от обычного ESP32.

Перед выкаткой обновлений проверяются резервные пути восстановления и совместимость версий ядра платформы. Скилл не подтверждает наличие безопасной загрузки или криптографической подписи образа. Эти параметры проверяются на целевом железе отдельно.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add wedsamuel1230/embedded-engineering-skills --skill ota-deployment-guardian -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/ota-deployment-guardian/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/ota-deployment-guardian/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add wedsamuel1230/embedded-engineering-skills --skill ota-deployment-guardian -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/ota-deployment-guardian/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add wedsamuel1230/embedded-engineering-skills --skill ota-deployment-guardian -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/ota-deployment-guardian/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install wedsamuel1230/embedded-engineering-skills skills/ota-deployment-guardian
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/ota-deployment-guardian/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add wedsamuel1230/embedded-engineering-skills --skill ota-deployment-guardian -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/wedsamuel1230/embedded-engineering-skills --path skills/ota-deployment-guardian
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/ota-deployment-guardian/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add wedsamuel1230/embedded-engineering-skills --skill ota-deployment-guardian -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/wedsamuel1230/embedded-engineering-skills/tree/HEAD/skills/ota-deployment-guardian/SKILL.md

## Когда брать
- предотвратить потерю OTA-порта после загрузки нового скетча
- разобрать причины сбоев, когда устройство пингуется, но порт загрузки исчезает
- спланировать механизм отката прошивки для удалённых плат
- настроить обработку слотов загрузки и разделов NVS в native ESP-IDF

## Примеры запросов агенту
- Плата ESP32 пингуется в локальной сети, но сетевой порт пропадает в IDE. Как найти сбой?
- Проверь скетч для Arduino Uno R4 WiFi перед OTA-прошивкой, чтобы не потерять удалённый доступ
- Подготовь план отката прошивки и схему NVS для удалённого датчика на ESP-IDF

## Похожие
- [esp32-ai-agent-skill](https://affpapa.org/nevibecode/plugins/esp32-ai-agent-skill.md) — плагин · ★ 59 у репозитория
- [esp32c6-touch-lcd147](https://affpapa.org/nevibecode/skills/esp32c6-touch-lcd147.md) — скилл · ★ 29 у репозитория
- [esp32-wroom-38pin](https://affpapa.org/nevibecode/skills/esp32-wroom-38pin.md) — скилл · ★ 29 у репозитория
- [ESP32 Simulator](https://affpapa.org/nevibecode/mcp/esp32-simulator.md) — MCP-сервер · ★ 8 у репозитория
- [esp32-firmware-engineer](https://affpapa.org/nevibecode/skills/esp32-firmware-engineer.md) — скилл · 1500 установок
- [flashduck-dev](https://affpapa.org/nevibecode/skills/flashduck-dev.md) — скилл · ★ 187 у репозитория

Из того же набора: [wedsamuel1230/embedded-engineering-skills](https://affpapa.org/nevibecode/by/wedsamuel1230/embedded-engineering-skills.md) — 19 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
