arduino-cli-skill

Arduino CLI Skill

提供跨平台的 arduino-cli 工作流程与命令参考。

资源

references/commands.md - 开发板、核心、库、编译与上传命令
references/serial-ports.md - 针对不同操作系统的串口发现方法
rules/common-pitfalls.md - 常见命令错误与恢复指导
examples/README.md - 可运行的命令序列
../../docs/board-support/uno-r4-family.md - Uno R4 Minima 与 Uno R4 WiFi 支持说明

工作流程

确认用户的操作系统平台与目标开发板。
如果任务依赖端口发现，打开 references/serial-ports.md。
打开 references/commands.md 查看所需的具体命令族。
在建议上传或编译修复方案前，检查 rules/common-pitfalls.md。
如果目标是 Uno R4 系列，且问题涉及 WiFi、固件桥接或 OTA 相关设置，打开 ../../docs/board-support/uno-r4-family.md。
当结果需要被解析或复用时，优先使用 arduino-cli 的 JSON 输出。

兼容性与证明边界

在更改命令前，记录 arduino-cli version、核心/索引版本、FQBN、库、宿主操作系统与端口。检查库的架构支持与开发板包兼容性。编译成功仅证明构建通过；上传被接受仅证明上传通过，并不代表硬件或系统层面的成功。对于 IDE、PlatformIO 或厂商特定命令，应路由到相应分支，而不是静默翻译。

快速开始

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

验证

确认 fqbn 与目标开发板匹配。
在上传前确认所选串口存在。
排查问题时优先使用命令输出，而非记忆中的默认值。

详细示例见 references/commands.md 与 references/serial-ports.md。

共享输出契约

使用共享 Arduino 技能契约：说明假设、所需工具与版本、实现步骤、按证明阶段划分的测试/证据、已知限制以及恢复/安全注意事项。