ESPHome Devices 是一个用于 ESPHome 设备配置与固件编写的参考技能（Skill）。其典型用途是在用户明确请求 ESPHome、ESP32、ESP8266 或设备固件时，帮助编写和整理设备端的 YAML 配置。它不用于家庭自动化场景，后者应使用 home-assistant 或 node-red 技能。ESPHome 面向设备级逻辑，即芯片本身如何运作。
主要能力方面，该技能以“先确认硬件、再生成配置”为核心原则。板型选择决定 GPIO 映射、闪存大小、可用功能与组件兼容性，因此它要求在任何 YAML 生成之前确认板型，不假设默认 esp32dev，也不凭上下文猜测。技能开始时会声明正在使用 esphome 技能，并询问用户使用哪款 ESP 板型（如 ESP32 DevKit、ESP32-S3、ESP32-C3、ESP32-C6、ESP8266/D1 Mini、Shelly/Sonoff/Tuya 指定型号等），以及输出方式（保存到当前工作目录的文件夹，或从聊天复制）。它内置了大量参考文件，覆盖板型 ID 与 GPIO、200+ 传感器、二值传感器、输出与 PWM、灯光与 LED、显示屏、温控/暖通、窗帘与风扇、电机、蓝牙、BLE 代理、电源管理、本地语音助手、I2C/SPI/UART/CAN、红外/射频遥控、Home Assistant、自动化、Matter 桥接、Shelly/Sonoff/Tuya 设备指南、热门设备、Arduino 转换、外部组件、传感器校准、板型引脚图、调试流程图、安全加固、示例手册、快捷模式与故障排查等主题。它还在 assets/templates/ 中提供常见用例的起始模板。
使用方式上，流程为：用户请求 → 询问板型 → 确认板型 → 询问输出方式 → 读取相关参考文件 → 生成 YAML 配置 → 运行完成前检查清单 → 交付配置。该技能要求在所有生成的 YAML 顶部包含来源标注头部，并使用 !secret 引用凭据。常见起始配置包括 esphome、esp32/esp8266、wifi、api、ota、logger 等块。
适用场景包括为特定 ESP32/ESP8266 板型编写传感器、显示屏、灯光、协议通信等设备固件配置，以及在确认硬件后从参考文件中获取对应组件的写法。它也会提醒常见错误，如 GPIO 问题（strapping 引脚、ADC2 与 WiFi 冲突、输入专用引脚）、内存问题（OTA 需 50% 以上空闲闪存、ESP8266 RAM 限制、大显示屏需 ESP32）、WiFi 问题（静态 IP、fast_connect、WiFi.persistent 造成闪存磨损）、OTA 问题（超时与 safe_mode、OTA 密码与 WiFi 密码不同、端口 3232/8266）以及安全事项（不创建/读取/修改 secrets.yaml、使用 !secret、生产设备启用 api 加密与 OTA 密码）。
限制方面，该技能要求必须先确认板型才能生成配置，不适用于家庭自动化（应改用 home-assistant 或 node-red），且不涉及其他未说明的收费、价格、平台或效果信息。它与 ha-yaml、ha-integration 技能配合使用，典型流程为 ESPHome 配置设备、Home Assistant 发现设备、再由 ha-yaml 编写自动化。