esp-idf-local-debug-handoff

Self-contained prompt for a LOCAL Hermes agent to debug/build ESP-IDF firmware (M5Stack Stick S3) on Windows. Use when the remote agent can't build (no ESP-IDF toolchain/space) and the user wants a local agent to run the error→fix→rebuild loop directly. Includes v6.0 environment activation (idf_cmd_init.bat) which is the critical gotcha.

설치로 이동

저장소: ohrbit/hermes_plugins
최근 소스 활동: 2026년 7월 17일 00:33
감지된 SKILL.md 언어: 영어
스타: 3
포크: 0

설치 방법

기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.

npx skills add https://github.com/ohrbit/hermes_plugins --skill esp-idf-local-debug-handoff

명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.

로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.

소스 파일 검토

설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.

SKILL.md

소스 지침 · 읽기 전용 미리보기

name	esp-idf-local-debug-handoff
description	Self-contained prompt for a LOCAL Hermes agent to debug/build ESP-IDF firmware (M5Stack Stick S3) on Windows. Use when the remote agent can't build (no ESP-IDF toolchain/space) and the user wants a local agent to run the error→fix→rebuild loop directly. Includes v6.0 environment activation (idf_cmd_init.bat) which is the critical gotcha.

ESP-IDF Local Debug Handoff (Stick S3 firmware)

When to use

Remote Hermes can't build ESP-IDF (no toolchain, no disk space)
User has ESP-IDF installed locally (Windows, v6.0.x via Espressif IDE)
Build-debug loop should run on user's machine, not round-trip to remote

CRITICAL: v6.0 environment activation

The Espressif IDE shortcut runs idf_cmd_init.bat first — this sets IDF_PATH, PATH, and the Python venv. A bare idf.py in a fresh shell fails ("command not found"). Each agent shell call is fresh, so you MUST chain activation + build in ONE command:

call "C:\Espressif\idf_cmd_init.bat" && cd /d C:\hermes_plugins\esp-hermes\firmware && idf.py build

If the path differs, find it:

dir "C:\Espressif\idf_cmd_init.bat"

(v5 used export.bat; v6 renamed it to idf_cmd_init.bat.)

The handoff prompt (copy verbatim to local Hermes)

Du debuggst den Firmware-Build von "esp-hermes" — M5Stack Stick S3 (ESP32-S3)
als Voice/IO-Client für den Hermes AI Gateway. Device verbindet per WebSocket
mit Gateway, capturet Audio, rendert Pet/TUI auf LCD, liest IMU-Gesten,
führt IO-Tool-Calls aus.

UMGEBUNG:
- OS: Windows, ESP-IDF v6.0.2 (Espressif IDE installiert)
- Pfad: C:\hermes_plugins\esp-hermes\firmware  (Repo: ohrbit/hermes_plugins, branch main)
- Du hast PowerShell/CMD-Zugriff. ESP-IDF-Env MUSS geladen werden:
  call "C:\Espressif\idf_cmd_init.bat" && cd /d C:\hermes_plugins\esp-hermes\firmware
  (jeder Build-Befehl braucht das Prefix — sonst "idf.py not found")

BUILD (ein Befehl):
  call "C:\Espressif\idf_cmd_init.bat" && cd /d C:\hermes_plugins\esp-hermes\firmware && idf.py build
  (falls "target not set": set-target esp32s3 voranstellen)

SCHON GEFIXT (nicht erneut anfassen):
- esp_websocket_client + espressif/cjson = Component-Manager-Deps in idf_component.yml
- i2c/ledc/uart/spi_flash in `driver` (kein eigenes REQUIRES)
- json(cJSON) in v6 entfernt -> #include <cjson/cJSON.h>, Dep espressif/cjson
- sdkconfig.defaults: FLASH 8MB (CONFIG_ESPTOOLPY_FLASHSIZE="8MB"),
  LOG level = int (3=INFO), keine ESP_WIFI_*-Symbole (kommen via NVS)
- partitions.csv: 8MB Flash (factory 3MB, storage ~5MB)
- ADC: neue esp_adc oneshot-API (adc1_get_raw in v5+ entfernt)

STICK-S3 PINMAP (nicht ändern außer begründet):
- LCD ST7789P3: MOSI=G39 SCK=G40 RS=G45 CS=G41 RST=G21 BL=G38
- IMU BMI270: SCL=G48 SDA=G47  (I2C addr 0x68)
- Audio ES8311: MCLK=G18 DOUT=G14 BCLK=G17 LRCK=G15 DIN=G16
- Buttons: KEY1=G11 (PTT) KEY2=G12 (mode toggle)

WICHTIG — STALE SDKCONFIG:
Bei Partition-Error "does not fit in configured flash size 2MB":
  del C:\hermes_plugins\esp-hermes\firmware\sdkconfig
  (dann rebuild — sdkconfig.defaults setzt nur Defaults für UNSET-Werte)

AUFGABE:
idf.py build ausführen. FÜR JEDEM Fehler:
1. echten Fehler aus Build-Output lesen (nicht raten)
2. relevantes File in firmware\main\ fixen
3. rebuild
4. wiederholen bis firmware.bin entsteht

CONSTRAINTS:
- esp_hermes.h = WS-Protokoll-Contract mit Gateway. Nur ändern wenn Build es erzwingt.
- Pin-Safety in io_tools.c (eh_pin_is_blocked) NICHT entfernen.
- Device = Gateway-CLIENT, kein LLM drauf. Dünn halten.
- v6-API-Kompatibilität Prio 1. LCD/ES8311/BMI270-Init aus Datasheet ->
  vermutlich erste echte Compile-Fehler dort.
- EDITIEREN LOKAL. Kein git commit/push ohne explizite Erlaubnis.
- Melde was du geändert hast.

WENN BUILD OK: firmware.bin Pfad + Größe nennen, verbleibende TODOs
(ungetestete HW-Init, stubbed Audio-Codec) auflisten.

Pitfalls

Each shell is fresh → always prefix with call idf_cmd_init.bat && cd ...
Stale sdkconfig → delete it when flash-size/partition errors persist
v6 renames: export.bat→idf_cmd_init.bat, json→espressif/cjson
Don't push → keep user in control of the repo

Verify

After local agent reports success, ask for the firmware.bin path + size, then optionally commit via the safe-push script on the REMOTE agent side.

검색으로 돌아가기 설치로 돌아가기

esp-hermes-channel

Build the ESP32-S3 (M5Stack) as a first-class Hermes voice channel — like Telegram/Desktop, not a standalone agent. Covers architecture, audio pipeline, 2-mode design (always-on VAD + push-to-talk), and petdex LCD rendering via gateway state-push.

2026-07-17

github-safe-push

Push files to a GitHub repo WITHOUT git branch chaos — uses the GitHub Contents API (PUT) directly, bypassing local git state. Use when local git branches are messy, commits landed on wrong branch, or you need idempotent repo updates. Created after esp-hermes branch-hell.

2026-07-17

이 저장소의 모든 Skills 보기

name	esp-idf-local-debug-handoff
description	Self-contained prompt for a LOCAL Hermes agent to debug/build ESP-IDF firmware (M5Stack Stick S3) on Windows. Use when the remote agent can't build (no ESP-IDF toolchain/space) and the user wants a local agent to run the error→fix→rebuild loop directly. Includes v6.0 environment activation (idf_cmd_init.bat) which is the critical gotcha.

ESP-IDF Local Debug Handoff (Stick S3 firmware)

When to use

Remote Hermes can't build ESP-IDF (no toolchain, no disk space)
User has ESP-IDF installed locally (Windows, v6.0.x via Espressif IDE)
Build-debug loop should run on user's machine, not round-trip to remote

CRITICAL: v6.0 environment activation

call "C:\Espressif\idf_cmd_init.bat" && cd /d C:\hermes_plugins\esp-hermes\firmware && idf.py build

If the path differs, find it:

dir "C:\Espressif\idf_cmd_init.bat"

(v5 used export.bat; v6 renamed it to idf_cmd_init.bat.)

The handoff prompt (copy verbatim to local Hermes)

Du debuggst den Firmware-Build von "esp-hermes" — M5Stack Stick S3 (ESP32-S3)
als Voice/IO-Client für den Hermes AI Gateway. Device verbindet per WebSocket
mit Gateway, capturet Audio, rendert Pet/TUI auf LCD, liest IMU-Gesten,
führt IO-Tool-Calls aus.

UMGEBUNG:
- OS: Windows, ESP-IDF v6.0.2 (Espressif IDE installiert)
- Pfad: C:\hermes_plugins\esp-hermes\firmware  (Repo: ohrbit/hermes_plugins, branch main)
- Du hast PowerShell/CMD-Zugriff. ESP-IDF-Env MUSS geladen werden:
  call "C:\Espressif\idf_cmd_init.bat" && cd /d C:\hermes_plugins\esp-hermes\firmware
  (jeder Build-Befehl braucht das Prefix — sonst "idf.py not found")

BUILD (ein Befehl):
  call "C:\Espressif\idf_cmd_init.bat" && cd /d C:\hermes_plugins\esp-hermes\firmware && idf.py build
  (falls "target not set": set-target esp32s3 voranstellen)

SCHON GEFIXT (nicht erneut anfassen):
- esp_websocket_client + espressif/cjson = Component-Manager-Deps in idf_component.yml
- i2c/ledc/uart/spi_flash in `driver` (kein eigenes REQUIRES)
- json(cJSON) in v6 entfernt -> #include <cjson/cJSON.h>, Dep espressif/cjson
- sdkconfig.defaults: FLASH 8MB (CONFIG_ESPTOOLPY_FLASHSIZE="8MB"),
  LOG level = int (3=INFO), keine ESP_WIFI_*-Symbole (kommen via NVS)
- partitions.csv: 8MB Flash (factory 3MB, storage ~5MB)
- ADC: neue esp_adc oneshot-API (adc1_get_raw in v5+ entfernt)

STICK-S3 PINMAP (nicht ändern außer begründet):
- LCD ST7789P3: MOSI=G39 SCK=G40 RS=G45 CS=G41 RST=G21 BL=G38
- IMU BMI270: SCL=G48 SDA=G47  (I2C addr 0x68)
- Audio ES8311: MCLK=G18 DOUT=G14 BCLK=G17 LRCK=G15 DIN=G16
- Buttons: KEY1=G11 (PTT) KEY2=G12 (mode toggle)

WICHTIG — STALE SDKCONFIG:
Bei Partition-Error "does not fit in configured flash size 2MB":
  del C:\hermes_plugins\esp-hermes\firmware\sdkconfig
  (dann rebuild — sdkconfig.defaults setzt nur Defaults für UNSET-Werte)

AUFGABE:
idf.py build ausführen. FÜR JEDEM Fehler:
1. echten Fehler aus Build-Output lesen (nicht raten)
2. relevantes File in firmware\main\ fixen
3. rebuild
4. wiederholen bis firmware.bin entsteht

CONSTRAINTS:
- esp_hermes.h = WS-Protokoll-Contract mit Gateway. Nur ändern wenn Build es erzwingt.
- Pin-Safety in io_tools.c (eh_pin_is_blocked) NICHT entfernen.
- Device = Gateway-CLIENT, kein LLM drauf. Dünn halten.
- v6-API-Kompatibilität Prio 1. LCD/ES8311/BMI270-Init aus Datasheet ->
  vermutlich erste echte Compile-Fehler dort.
- EDITIEREN LOKAL. Kein git commit/push ohne explizite Erlaubnis.
- Melde was du geändert hast.

WENN BUILD OK: firmware.bin Pfad + Größe nennen, verbleibende TODOs
(ungetestete HW-Init, stubbed Audio-Codec) auflisten.

Pitfalls

Each shell is fresh → always prefix with call idf_cmd_init.bat && cd ...
Stale sdkconfig → delete it when flash-size/partition errors persist
v6 renames: export.bat→idf_cmd_init.bat, json→espressif/cjson
Don't push → keep user in control of the repo

Verify

After local agent reports success, ask for the firmware.bin path + size, then optionally commit via the safe-push script on the REMOTE agent side.

esp-idf-local-debug-handoff

소스 정보

설치 방법

소스 파일 검토

ESP-IDF Local Debug Handoff (Stick S3 firmware)

When to use

CRITICAL: v6.0 environment activation

The handoff prompt (copy verbatim to local Hermes)

Pitfalls

Verify

이 저장소의 다른 Skills

ESP-IDF Local Debug Handoff (Stick S3 firmware)

When to use

CRITICAL: v6.0 environment activation

The handoff prompt (copy verbatim to local Hermes)

Pitfalls

Verify

이 저장소의 다른 Skills