mcpField
A
arduino-cli-skill

arduino-cli-skill

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

关于 arduino-cli-skill

arduino-cli-skill 是面向 `arduino-cli` 使用者的技能，提供跨平台命令流程与故障排查指导，并检查开发板兼容性、串口及编译和上传结果的证明范围。

主要功能

  1. 01提供开发板、核心、库、编译和上传命令指导
  2. 02提供按操作系统区分的串口查找说明
  3. 03检查开发板包与库的兼容性
  4. 04区分编译证明与上传证明
  5. 05说明可复用结果的 JSON 输出方式

适用场景

  1. 01上传前查找开发板和串口
  2. 02为指定开发板编译草图
  3. 03排查命令、兼容性或上传问题

安装

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

$npx skills add https://github.com/wedsamuel1230/arduino-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