القائمة
当需要通过 PlatformIO 内置调试功能对目标板进行 GDB 调试时使用，支持下载暂停、附加和崩溃现场分析。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
嵌入式开发技能集的总控入口。负责两类任务：(1) 用户请求安装本仓库 skill 时，引导选择全部或按需安装；(2) 用户发出模糊指令（如"烧录"、"编译"、"调试"）且无法自动判断应使用哪个具体 skill 时，列出同分类下的候选 skill 供用户选择。
当需要使用已探测或显式指定的产物与探针配置，调用自带脚本通过 OpenOCD 烧录嵌入式固件时使用。
当需要识别正确串口、调用自带脚本抓取日志，并分析嵌入式固件运行状态时使用。
当需要串联多个 skill 完成编译+烧录+监控或编译+烧录+调试等流水线任务时使用。
当需要用 Saleae 逻辑分析仪在线采集数字波形并解码 I2C/SPI/UART/CAN 时使用，通过 Logic 2 自动化服务驱动硬件采集、添加协议解码器并导出数据。
当需要通过 Keil MDK 命令行编译嵌入式工程，调用自带脚本解析工程文件、执行构建并定位固件产物时使用。
استنادا إلى تصنيف SOC المهني
| name | debug-platformio |
| description | 当需要通过 PlatformIO 内置调试功能对目标板进行 GDB 调试时使用，支持下载暂停、附加和崩溃现场分析。 |
Project Profile 中标明 build_system: platformio 或工作区中存在 platformio.ini。platformio.ini）。pio CLI。platformio.ini 中的 debug_tool 配置。python scripts/pio_debugger.py --detect --project-dir <工程目录> --env <环境名>
python scripts/pio_debugger.py --project-dir <工程目录> --env <环境名> --mode download-and-halt
download-and-halt：下载固件到目标板，暂停在入口点，输出寄存器和回溯信息。attach-only：附加到正在运行的目标，不下载固件，输出当前状态。crash-context：暂停目标，读取寄存器、完整回溯和 Cortex-M Fault 寄存器（CFSR/HFSR/MMFAR/BFAR）。connection-failure：调试器未连接或设备无响应。debug-not-supported：板卡不支持调试或未配置 debug_tool。debug-failure：调试会话异常终止。示例输出格式：
调试完成 ✅
工程: ESP32_DEV → 环境: esp32dev
板卡: esp32dev | 调试工具: esp-prog
模式: download-and-halt
关键观察: 5 条（寄存器、回溯帧）
build-platformio 接收编译成功的工程信息。build-platformio 修改代码重新编译。