用途：为需要 Arduino CLI 命令的用户提供跨平台工作流与命令参考，涵盖开发板发现、核心与库安装、编译、上传以及串口排障。
主要能力：资料包含 references/commands.md（board、core、library、compile、upload 命令）、references/serial-ports.md（按操作系统区分串口发现）、rules/common-pitfalls.md（常见命令错误与恢复指引）、examples/README.md（可运行命令序列），以及 Uno R4 Minima 与 Uno R4 WiFi 支持说明。
使用方式：先确认用户平台与目标开发板；若任务依赖端口发现，查阅 serial-ports.md；按所需命令族查阅 commands.md；在给出编译或上传修复建议前先看 common-pitfalls.md；若目标为 Uno R4 且涉及 WiFi、固件桥或 OTA 相关设置，查阅对应板卡支持文档；结果需被解析或复用时优先使用 arduino-cli 的 JSON 输出。快速开始示例：arduino-cli board list、arduino-cli core list、arduino-cli compile --fqbn arduino:avr:uno path/to/sketch、arduino-cli upload -p /dev/ttyACM0 --fqbn arduino:avr:uno path/to/sketch。
适用场景：Arduino 开发板与核心管理、库安装、编译上传、串口问题排查，以及 Uno R4 系列相关设置。
限制与边界：更改命令前应记录 arduino-cli 版本、核心/索引版本、FQBN、库、主机操作系统与端口，并检查库架构支持与板卡包兼容性。编译成功仅为构建证明，上传被接受仅为上传证明，均不代表硬件或系统成功。IDE、PlatformIO 或厂商专用命令应转到相应分支，不应静默转换。验证时确认 FQBN 与目标板一致、上传前确认所选串口存在，排障时优先依据命令输出而非记忆中的默认值。输出契约要求说明假设、所需工具与版本、实现步骤、按证明阶段划分的测试/证据、已知限制及恢复/安全说明。