К основному содержанию
скилл CX Codex

ota-deployment-guardian — скилл для Claude Code: обзор и установка

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

MIT 115 установок ★ 33 обновлён 2026-10-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add wedsamuel1230/embedded-engineering-skills --skill ota-deployment-guardian -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/ota-deployment-guardian/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/ota-deployment-guardian/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
esp32-ai-agent-skill ezrover Плагин esp32-ai-agent-skill для Claude, который подбирает чип ESP32, проверяет назначение GPIO и генерирует код под Arduino и ESP-IDF. ★ 59звёзд репо esp32c6-touch-lcd147 alexex1993 Помогает писать прошивки под плату Waveshare ESP32-C6-Touch-LCD-1.47 на ESP-IDF и PlatformIO. Содержит распиновку, параметры дисплея JD9853 и сенсора AXS5106L. CX Codex +1 ★ 29звёзд репо esp32-wroom-38pin alexex1993 Скилл esp32-wroom-38pin для прошивки 38-пиновых плат ESP32-WROOM-32: карта выводов, безопасные GPIO, ловушки флеш-пинов и IO0, рецепты кода. CX Codex +1 ★ 29звёзд репо ESP32 Simulator stramanu MCP-сервер ESP32 Simulator для Claude Code запускает прошивки ESP32 в локальном эмуляторе без реальной платы. Инструмент перехватывает вывод UART, эмулирует ввод и проверяет логи на паники. CX Codex +1 ★ 8звёзд репо esp32-firmware-engineer adamlipecz Скилл esp32-firmware-engineer помогает писать, проверять и отлаживать прошивки ESP32 на ESP-IDF. При работе с железом сначала выясняет плату, вариант чипа и подключённые устройства. CX Codex +1 1 500установок flashduck-dev FlashCat-Jordan Скилл flashduck-dev для Claude Code помогает собирать и менять прошивки робота Flashduck. Запускается при работе с голосовой прошивкой, DuckClaw или общим шестисервоприводным оборудованием. CX Codex +1 ★ 187звёзд репо

Из того же набора19

Весь набор →
code-review-facilitator Скилл code-review-facilitator проверяет проекты Arduino, ESP32 и RP2040 на типичные ошибки, проблемы с памятью и недочёты структуры. Подходит для ревью перед публикацией или после новой функции. CX Codex +1 154установок readme-generator Скилл readme-generator генерирует README.md для проектов на Arduino, ESP32 и RP2040. Подходит, когда проект нужно документировать перед публикацией на GitHub. CX Codex +1 147установок sensor-calibration-workbench Скилл sensor-calibration-workbench ведёт калибровку CO2-сенсоров, тензодатчиков и других датчиков: от прогрева и эталонных измерений до хранения коэффициентов и проверки дрейфа. CX Codex +1 137установок i2c-bringup-diagnostician Скилл i2c-bringup-diagnostician помогает выявить сбои шины I2C на платах Arduino и ESP32: от подтяжки резисторов до ошибок библиотек. CX Codex +1 134установок freertos-patterns Скилл freertos-patterns подсказывает паттерны FreeRTOS на ESP32 и многоядерную координацию на RP2040 — очереди, мьютексы, задачи, уведомления. CX Codex +1 120установок mermaid-diagram-generator Скилл mermaid-diagram-generator для Claude Code строит диаграммы Mermaid по коду Arduino и описаниям встроенных систем. Показывает состояния, последовательности сигналов и архитектуру задач FreeRTOS. CX Codex +1 113установок field-power-and-connectivity-triager Скилл field-power-and-connectivity-triager для Claude Code помогает найти причину сбоев питания и связи, когда плата работает от USB, но ломается с рабочим источником. Проверяет просадки напряжения, пиковый ток, стабилизатор и проводку. CX Codex +1 113установок arduino-serial-monitor Скилл arduino-serial-monitor для Claude Code читает и анализирует вывод последовательного порта Arduino: логи загрузки, данные датчиков и ошибки связи. CX Codex +1 1установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой