arduino-cli-skill

Arduino CLI スキル

クロスプラットフォームの arduino-cli ワークフローとコマンドリファレンスを提供します。

リソース

• references/commands.md - ボード、コア、ライブラリ、コンパイル、アップロードのコマンド
• references/serial-ports.md - OS ごとのシリアルポートの検出
• 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、ライブラリ、ホスト OS、ポートを記録します。ライブラリのアーキテクチャサポートとボードパッケージの互換性を確認します。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 スキル共通の契約に従ってください。前提条件、必要なツールとバージョン、実装手順、証明段階ごとのテスト／証拠、既知の制限事項、復旧およびセキュリティに関する注意事項を明記します。