arduino-workflow-router

Arduino ワークフロールーター

このスキルは、複数分野にまたがる作業や全体を扱う組み込み開発の簡潔な入口として使用します。対象ボードと工程が確定している特定の作業では、専門スキルを直接読み込みます。

推奨するライフサイクルの開始手順

物理的な作業や複数セッションにわたる依頼では、まず embedded-project-loop を読み込みます。これにより、目標、次のアクション、証拠の範囲、ロールバック方法、およびユーザーが管理する物理的なゲートを定めます。その後、ここに戻ってボードとツールチェーンを選定します。

最初に読み込むもの

1. ../../docs/arduino-skill-contract.md を読みます。
2. 作業が複数セッションにわたる場合、または物理的な操作を伴う場合は、最初に embedded-project-loop を読み込むことを推奨します。実装を始める前に目標と次のタスクの状態を作成し、証拠ゲートを満たすまで開いたままにします。
3. ../../docs/board-support/board-profile-template.md に記入するか、不要な理由を明記します。
4. ボード名またはボードファミリーを特定する必要がある場合は、ピンを選ぶ前に ../board-support/SKILL.md と、インデックスに登録されたプロファイルを読み込みます。
5. ボードとハードウェアの確認事項について、references/board-intake.md を読みます。
6. IDE、CLI、PlatformIO、またはベンダーのバージョンやライブラリの互換性について、references/toolchain-selection.md を読みます。
7. 以下のルーティング表から専門スキルを選択します。
8. アップロード、起動、電源、またはファームウェアの復旧操作を行う前に references/failure-recovery.md を読みます。ネットワーク接続されたデバイスや更新可能なデバイスを扱う場合は、references/connected-device-security.md を読みます。

この順序で最初に読み込みます。必要に応じて読み込みます。参照資料は該当する条件に当てはまる場合にのみ読み込むため、ルーターは500行未満に保たれ、詳細なバリエーションは段階的に開示されます。

トリガーの優先順位

• 複合的な依頼、詳細が不明な依頼、または複数分野にまたがる依頼では、このルーターが最初のルートを決定します。arduino-project-builder や board-selection など、内容が重複する専門スキルより先に読み込みます。
• 物理的な作業や複数セッションにわたる依頼では、このルーターより先に embedded-project-loop を読み込み、その後このルーターに戻って複合的な専門スキルのルートを決定します。
• ボードとツールチェーンが確定している単一工程の依頼では、最も対象を絞った専門スキルを直接読み込みます。
• ボード名を指定した参照や機能の確認では、正確な識別情報と出典に基づくプロファイルを board-support が担当します。要件に基づくボードの選択や交換は board-selection が担当し、前者からの引き継ぎ情報を利用できます。
• 実装、配線、ライフサイクルに関する作業を伴わないボード選択の依頼は、board-selection から開始してもかまいません。他の分野が加わった場合は、このルーターに戻り、複合ワークフローの順序を維持します。
• arduino-serial-monitor と、別のシリアルデバッグスキルを同時に読み込まないでください。構造化された実行時の証拠は、既存のシリアルモニターが担当します。

インテークゲート

ピン、電圧、電流制限、メモリサイズ、周辺機器、プロトコル、ライブラリのバージョン、アップロードコマンドを推測で補わないでください。不足している値を尋ねるか、仮定であることを明確に示し、検証手順を添えて進めます。正確なボード、フレームワーク、ツールチェーン、ホスト、依存関係のバージョン、および希望する証明段階を記録します。

ルーティング表

必要な内容	次に読み込むもの	注目する証拠
要件またはボードの選定	board-selection、次に board-support、その後 arduino-project-builder	判断と設計
名前が指定されたボードの参照または機能の確認	board-support、次に該当する専門スキル	正確な識別情報とソースに裏付けられた制約
ピン配置または GPIO 宣言	board-support、次に pin-assignment、その後 wiring-safety-check	ボードの制約とハードウェア
配線、電圧、電流またはプルアップ	wiring-safety-check、power-budget-calculator、circuit-debugger	ハードウェア
ADC／センサーのノイズ、サンプリング、フィルタリングまたは信号調整	board-support、wiring-safety-check、sensor-signal-filtering、その後、検出が実証された場合に sensor-calibration-workbench	信号チェーンの設計と測定されたハードウェアの動作
コードパターンまたはボード抽象化	arduino-code-generator、non-blocking-patterns、memory-budgeting	ビルドとメモリ
ライブラリまたはフレームワークの依存関係	library-selection、次にコード／プロジェクトのスキル	互換性とメモリ
データシート、コンポーネントまたはプロトコルに関する不確実性	datasheet-interpreter、i2c-bringup-diagnostician	ハードウェアに関する前提
コンパイル、ボードの検出、アップロードまたはポート	arduino-cli-skill と error-message-explainer	ビルドとアップロード
実行時ログまたは現場での症状	arduino-serial-monitor、error-message-explainer、hardware-tdd	ハードウェアとシステム
タイミング、ブロッキングまたはウォッチドッグのリスク	non-blocking-patterns、hardware-tdd	ビルドとシステム
メモリまたはフットプリントのリスク	memory-budgeting、library-selection	ビルドと実行時
キャリブレーションまたはセンサーのドリフト	検出が実証された場合に sensor-calibration-workbench	システム
アプリケーション全体	arduino-project-builder、次に該当するドメインスキル	設計とビルド
接続を介したアップデートまたは現場へのデプロイ	ota-deployment-guardian とセキュリティの参考資料	デプロイ
部品、PCB 周辺または筐体に関する作業	bom-generator、enclosure-designer、readme-generator	設計と保守
ホスト／シミュレーション／ターゲットのテスト計画	物理的な作業が残っている場合は hardware-tdd と embedded-project-loop	証拠
複数セッションにまたがる作業、物理作業または復旧作業	まず embedded-project-loop、次にこのルーター	永続的な状態とユーザーが管理するゲート

複合ワークフロー

スキルは組み合わせて使用できます。各判断の担当は1つのスキルに統一し、その成果物を次のスキルに引き継ぎます。複合的な依頼では、次の簡潔なデフォルトの順序を使用します。

loop (if long-running) -> board selection/intake -> wiring safety -> library/memory -> project/code/timing -> toolchain build/upload -> serial and hardware tests -> system/calibration -> deployment/security/maintenance

デフォルトの複合順序は、arduino-workflow-router -> board-selection -> board-support -> pin-assignment -> wiring-safety-check -> sensor-signal-filtering -> non-blocking-patterns -> arduino-serial-monitor -> hardware-tdd です。作業が複数のセッションや物理的なゲートにまたがる場合は、 embedded-project-loop から始め、その後の各段階でも次の TODO と証拠台帳を 開いたままにします。

ユーザーがすでに正確でサポート対象のボード識別情報を提示している場合は、 board-selection を省略して board-support から開始します。ピンや電気的な アドバイスの前に board-support を省略してはいけません。

• バッテリー駆動の Wi-Fi センサー：ボードの情報収集 -> データシート -> 電源 -> プロジェクトビルダー -> コード生成ツール -> ツールチェーン -> シリアル／キャリブレーション -> OTA セキュリティ -> メンテナンス README。
• Uno R4 WiFi の書き込みトラブル：ボードファミリーのリファレンス -> IDE／CLI の特定 -> シリアルとエラーの診断 -> USB／電源の確認 -> ブートの復旧 -> 書き込みの 証明 -> ランタイム／システムの証明。../../docs/board-support/uno-r4-family.md を参照してください。
• ロボットコントローラー：ボードの情報収集 -> プロジェクトビルダー -> 電源／BOM -> 回路とコード -> シリアル／システムテスト -> 筐体 -> 署名付き更新とロールバック。
• 複数ボード対応のセンサーライブラリ：ボードプロファイル -> データシート／プロトコルの立ち上げ -> コード生成ツール -> IDE／CLI／PlatformIO の分岐 -> ボードごとのビルド証明と サポート対象外の動作の文書化。
• 4 ボタンの ESP32 コントローラー：ボード選定 -> ピン割り当て -> 配線の安全性 -> ノンブロッキングのデバウンス -> コード生成ツール -> ビルド証明 -> ハードウェア ゲート -> シリアル／システムの証拠。

スキルが実行された証拠として、表の行を扱わないでください。実際に使用したスキル、 それらが生成した成果物、および未検証のまま残っている証拠の段階を報告してください。

出力要件

../../docs/arduino-skill-contract.md を使用してください。前提条件、必要なツールと バージョン、実装手順、証明段階ごとのテスト／証拠、既知の制限事項、復旧／セキュリティに関する 注意事項を記載してください。