菜单
当需要通过 PlatformIO 内置调试功能对目标板进行 GDB 调试时使用，支持下载暂停、附加和崩溃现场分析。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
嵌入式开发技能集的总控入口。负责两类任务：(1) 用户请求安装本仓库 skill 时，引导选择全部或按需安装；(2) 用户发出模糊指令（如"烧录"、"编译"、"调试"）且无法自动判断应使用哪个具体 skill 时，列出同分类下的候选 skill 供用户选择。
当需要使用已探测或显式指定的产物与探针配置，调用自带脚本通过 OpenOCD 烧录嵌入式固件时使用。
当需要识别正确串口、调用自带脚本抓取日志，并分析嵌入式固件运行状态时使用。
当需要串联多个 skill 完成编译+烧录+监控或编译+烧录+调试等流水线任务时使用。
当需要用 Saleae 逻辑分析仪在线采集数字波形并解码 I2C/SPI/UART/CAN 时使用，通过 Logic 2 自动化服务驱动硬件采集、添加协议解码器并导出数据。
当需要通过 Keil MDK 命令行编译嵌入式工程，调用自带脚本解析工程文件、执行构建并定位固件产物时使用。
| 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 修改代码重新编译。