mcpField
A
arduino-cli-skill

arduino-cli-skill

github.com/wedsamuel1230开发28128 次安装2 周前更新
代码仓库

关于 arduino-cli-skill

为 Arduino CLI 提供跨平台工作流和命令参考的技能，面向需要编译、上传或排查 Arduino 项目的开发者。它强调核对开发板、平台、端口和版本，并区分编译与上传的验证范围。

主要功能

  1. 01提供开发板与核心命令参考
  2. 02指导串口端口发现
  3. 03支持编译和上传工作流
  4. 04说明常见错误及恢复方法
  5. 05强调版本与验证边界

适用场景

  1. 01使用 arduino-cli 编译项目
  2. 02查找上传所需的串口端口
  3. 03排查开发板或库兼容问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/wedsamuel1230/embedded-engineering-skills --skill arduino-cli-skill

安装后在 Claude Code 中输入/arduino-cli-skill确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

examples/
README.md
references/
commands.md
serial-ports.md
rules/
common-pitfalls.md
scripts/
workflow-windows.ps1

详细介绍

Arduino CLI 技能

提供跨平台的 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 支持说明

工作流

  1. 确认用户的平台和目标主板。
  2. 如果任务依赖串口发现，请打开 references/serial-ports.md。
  3. 打开 references/commands.md，查找所需的确切命令类别。
  4. 在建议上传或编译修复方案前，先查看 rules/common-pitfalls.md。
  5. 如果目标属于 Uno R4 系列，且问题涉及 WiFi、固件桥接或 OTA 相关设置，请打开 ../../docs/board-support/uno-r4-family.md。
  6. 如果结果需要解析或重复使用，优先使用 arduino-cli JSON 输出。

兼容性与验证边界

在更改命令前，记录 arduino-cli version、核心/索引版本、FQBN、库、主机操作系统和串口。检查库的架构支持情况和主板软件包兼容性。compile 成功只能证明构建通过；上传被接受只能证明上传通过，并不能证明硬件或系统运行成功。对于 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 技能约定：说明假设、所需工具及版本、实施步骤、各验证阶段的测试/证据、已知限制，以及恢复/安全注意事项。

评论

支持 Markdown