ota-deployment-guardian — скилл для Claude Code: обзор и установка
Скилл ota-deployment-guardian защищает удалённые платы ESP32 и Arduino Uno R4 WiFi от окирпичивания при OTA-обновлениях. Помогает настроить откат прошивки и разобрать сбои сетевых портов.
MIT 115 установок ★ 33 обновлён 2026-10-15
npx skills add wedsamuel1230/embedded-engineering-skills --skill ota-deployment-guardian -a claude-codeЧто делает ota-deployment-guardian
Скилл проверяет прошивки перед удалённой загрузкой по воздуху на ESP32, Nano ESP32 и Arduino Uno R4 WiFi. Он разделяет проблемы доступности сети и обнаружения mDNS-портов в IDE. Если плата пингуется, это ещё не гарантирует успешную прошивку по воздуху.
Ассистент напоминает сохранить обработчик OTA в новом коде скетча, чтобы не потерять удалённый доступ навсегда. Для чистого ESP-IDF предусмотрен разбор слотов приложений, подтверждения загрузки и схем NVS. С платой Uno R4 WiFi учитываются ограничения её сетевого модуля, чья архитектура отличается от обычного ESP32.
Перед выкаткой обновлений проверяются резервные пути восстановления и совместимость версий ядра платформы. Скилл не подтверждает наличие безопасной загрузки или криптографической подписи образа. Эти параметры проверяются на целевом железе отдельно.
Какие задачи решает
- предотвратить потерю OTA-порта после загрузки нового скетча
- разобрать причины сбоев, когда устройство пингуется, но порт загрузки исчезает
- спланировать механизм отката прошивки для удалённых плат
- настроить обработку слотов загрузки и разделов NVS в native ESP-IDF
Примеры запросов агенту
- Плата ESP32 пингуется в локальной сети, но сетевой порт пропадает в IDE. Как найти сбой?
- Проверь скетч для Arduino Uno R4 WiFi перед OTA-прошивкой, чтобы не потерять удалённый доступ
- Подготовь план отката прошивки и схему NVS для удалённого датчика на ESP-IDF
Как установить ota-deployment-guardian
1Через Skills CLI (Vercel)
npx skills add wedsamuel1230/embedded-engineering-skills --skill ota-deployment-guardian -a claude-code2Вручную: положить файлы
~/.claude/skills/ota-deployment-guardian/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ota-deployment-guardian/
1Через Skills CLI (Vercel)
npx skills add wedsamuel1230/embedded-engineering-skills --skill ota-deployment-guardian -a codex2Вручную: положить файлы
.agents/skills/ota-deployment-guardian/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wedsamuel1230/embedded-engineering-skills --skill ota-deployment-guardian -a cursor2Вручную: положить файлы
.cursor/skills/ota-deployment-guardian/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wedsamuel1230/embedded-engineering-skills skills/ota-deployment-guardian2Вручную: положить файлы
.github/skills/ota-deployment-guardian/SKILL.md1Через Skills CLI (Vercel)
npx skills add wedsamuel1230/embedded-engineering-skills --skill ota-deployment-guardian -a gemini-cli2Командой платформы
gemini skills install https://github.com/wedsamuel1230/embedded-engineering-skills --path skills/ota-deployment-guardianВручную: положить файлы
.devin/skills/ota-deployment-guardian/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add wedsamuel1230/embedded-engineering-skills --skill ota-deployment-guardian -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об ota-deployment-guardian
Как установить ota-deployment-guardian в Claude Code?
Выполните в терминале команду npx skills add wedsamuel1230/embedded-engineering-skills --skill ota-deployment-guardian -a claude-code. Конфигурация появится в файле ~/.claude/skills/ota-deployment-guardian/SKILL.md.
Что делает ota-deployment-guardian?
Скилл регламентирует безопасное обновление микроконтроллеров по воздуху. Он помогает сохранить OTA-интерфейс в коде и подготовить сценарий отката при сбое.
Почему успешный ping не означает готовность платы к OTA?
Ответ на ICMP-пакеты подтверждает только базовую связность на уровне IP. Механизм обнаружения mDNS и приёмный сервис OTA внутри скетча могут быть не запущены или зависнуть.
Исходный текст
SKILL.md · MIT
---
name: ota-deployment-guardian
description: Use when users need safe over-the-air update workflows for ESP32-class boards or Arduino Uno R4 WiFi, including OTA sketch requirements, network port discovery failures, remote recovery planning, and rollout safety checks.
metadata: {triggers: "OTA, over-the-air update, rollback, remote recovery, deployment"}
---
# OTA Deployment Guardian
Use this skill when a device is updated remotely and losing the update path
would be expensive.
## Resources
- `references/ota-safe-sketch.md` - minimum sketch-side OTA contract and guardrails
- `references/discovery-and-network-ports.md` - IDE, mDNS, IP reachability, and disappearing network port triage
- `references/recovery-and-rollback.md` - rollout safety, rollback, and last-resort recovery planning
- `references/native-espidf-rollback.md` - native app slots, boot acceptance, stopped-output acknowledgement and rollback-compatible NVS/calibration schemas
- `../../docs/board-support/uno-r4-family.md` - Uno R4 Minima and Uno R4 WiFi board-family caveats
## When to Use
Use this skill when the request involves:
- OTA uploads for ESP32, Nano ESP32, or Uno R4 WiFi
- network port appears briefly or disappears
- IDE can ping the device but cannot upload
- keeping a remote weather station or deployed board updateable
- avoiding self-bricking after an OTA deployment
Do not use this skill for ordinary bench USB uploads unless the user is clearly
preparing for later OTA deployment.
## Workflow
1. Confirm the board family:
- Native ESP-IDF -> open `references/native-espidf-rollback.md`; build intake
stays with `embedded-build-workflow`, not Arduino sketch instructions.
- ESP32 or Nano ESP32 -> open `references/ota-safe-sketch.md`
- Uno R4 WiFi -> also open `../../docs/board-support/uno-r4-family.md`
2. Separate discovery failures from sketch failures:
- ping works but network port disappears -> open
`references/discovery-and-network-ports.md`
- OTA works once, then disappears after the new sketch runs -> verify the new
sketch still implements the OTA path in `ota-safe-sketch.md`
3. Before suggesting a rollout, check `references/recovery-and-rollback.md` for
recovery path, rollback strategy, and what must stay available over USB.
4. Treat core-version changes as a possible variable when OTA previously worked
and later became unreliable.
## Security And Maintenance Boundary
Use the router's connected-device security reference for secrets, signed images,
dependency versions, staged rollout, rollback, vulnerability response, and
decommissioning. This skill's board-specific OTA procedures do not prove that
the device has secure boot, authenticated updates, or a recoverable field
deployment; verify those controls on the exact target.
## Core Rules
- Never assume OTA remains available after a new sketch unless the sketch keeps
the OTA path alive.
- Distinguish reachability from OTA discovery. Ping success does not prove the
IDE can discover or upload.
- Keep at least one recovery path in reserve for high-cost remote devices.
- For Uno R4 WiFi, keep board-family caveats explicit. Its WiFi side is not the
same operational model as a plain ESP32 board.
## Verification
- Confirm the sketch still connects to the intended network and services the OTA
path after boot.
- Confirm whether the failure is discovery-only, upload-only, or full device
reachability loss.
- For remote deployments, confirm the rollback or physical recovery plan before
recommending an update.
- If board or core versions changed recently, capture the exact versions before
concluding the failure is in user code.
## Integration
- Pair with `arduino-cli-skill` when the user needs command-line upload or port
inspection.
- Pair with `field-power-and-connectivity-triager` when the OTA path fails only
off USB or in field power conditions.
- Pair with `error-message-explainer` when the OTA sketch itself does not build.
## Shared Output Contract
Use [the shared Arduino skill contract](../../docs/arduino-skill-contract.md):
state assumptions, required tools and versions, implementation steps,
tests/evidence by proof stage, known limitations, and recovery/security notes.
© wedsamuel1230 · MIT · wedsamuel1230/embedded-engineering-skills