القائمة
当需要通过 PlatformIO 烧录固件到目标板时使用，利用 platformio.ini 中的上传配置自动完成烧录。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
嵌入式开发技能集的总控入口。负责两类任务：(1) 用户请求安装本仓库 skill 时，引导选择全部或按需安装；(2) 用户发出模糊指令（如"烧录"、"编译"、"调试"）且无法自动判断应使用哪个具体 skill 时，列出同分类下的候选 skill 供用户选择。
当需要使用已探测或显式指定的产物与探针配置，调用自带脚本通过 OpenOCD 烧录嵌入式固件时使用。
当需要识别正确串口、调用自带脚本抓取日志，并分析嵌入式固件运行状态时使用。
当需要串联多个 skill 完成编译+烧录+监控或编译+烧录+调试等流水线任务时使用。
当需要用 Saleae 逻辑分析仪在线采集数字波形并解码 I2C/SPI/UART/CAN 时使用，通过 Logic 2 自动化服务驱动硬件采集、添加协议解码器并导出数据。
当需要通过 Keil MDK 命令行编译嵌入式工程，调用自带脚本解析工程文件、执行构建并定位固件产物时使用。
| name | flash-platformio |
| description | 当需要通过 PlatformIO 烧录固件到目标板时使用，利用 platformio.ini 中的上传配置自动完成烧录。 |
Project Profile 中标明 build_system: platformio 或工作区中存在 platformio.ini。platformio.ini 中的 upload_protocol 决定。platformio.ini）。.em_skill.json 中上次成功的 profile 作为默认参数（显式参数优先，无需先手动传 --resume）；--resume 仅用于断言缓存必须存在，无缓存则非零退出。无缓存或用户明确要求重新探测时，脚本自动回退到正常扫描。pio CLI。platformio.ini 中的环境列表和 upload_protocol。default_envs 或第一个环境。python scripts/pio_flasher.py --flash --project-dir <工程目录> --env <环境名>
python scripts/pio_flasher.py --flash --project-dir <工程目录> --env <环境名> --upload-port COM3
Project Profile，推荐下一步 skill。connection-failure：设备未连接、串口被占用或权限不足。project-config-error：板卡配置无效或环境名不存在。upload-failure：上传过程中出错。示例输出格式：
烧录成功 ✅
工程: ESP32_DEV → 环境: esp32dev
板卡: esp32dev | 平台: espressif32
固件: firmware.bin (200.0 KB)
耗时: 15.3 秒
serial-monitor（查看串口输出）或 debug-platformio（在线调试）。build-platformio 接收编译成功的工程信息。serial-monitor（查看串口输出）或 debug-platformio（在线调试）。