SuperAPI AI 工具集

arduino-workflow-router

编程与开发

查看项目

更新于 10-16 01:58

技能介绍

用途

Arduino Workflow Router 是完整或跨学科嵌入式工作的简洁入口点。当请求同时涉及固件、开发板、接线、调试、构建上传等多个环节,或需求描述不完整、需要先确定开发板与工具链时,使用此路由器进行路由。对于已确认开发板和单一阶段的聚焦任务,应直接加载最窄的专项技能。

主要能力

  • 作为跨领域嵌入式请求的第一路由,负责在 Arduino IDE、Arduino CLI、PlatformIO 及厂商专用工具之间分发。
  • 提供推荐的生命周期入口:对于任何物理或多会话请求,先加载 embedded-project-loop,建立目标、下一步行动、证据边界、回滚路径和用户拥有的物理门禁,然后返回此处进行开发板与工具链路由。
  • 提供路由表,按需求将请求导向专项技能,例如 Zephyr 开发、STM32 开发、Pico SDK 开发、MicroPython 开发、探针调试、故障取证、总线调试、启动与烧录恢复、内存与时序调试、USB 调试、需求或开发板选择、命名开发板参考、引脚映射、接线安全、ADC/传感器噪声、代码模式、库依赖、数据手册解释、编译上传、PlatformIO/ESP-IDF 构建、实时控制、无线遥测、运行时日志、时序阻塞、内存占用、校准漂移、完整应用、连接更新部署、零件/PCB/外壳、主机/仿真/目标测试计划、多会话物理恢复等。
  • 定义触发优先级:组合、未充分指定或跨学科请求由本路由器拥有第一路由;物理或多会话请求先加载 embedded-project-loop;单一阶段且已确认开发板和工具链的请求直接加载最窄专项技能;命名开发板参考由 board-support 负责精确身份和来源支持的档案;开发板选择由 board-selection 负责。
  • 提供组合工作流默认顺序:loop(若长期运行)-> 开发板选择/录入 -> 接线安全 -> 库/内存 -> 项目/代码/时序 -> 工具链构建/上传 -> 串口与硬件测试 -> 系统/校准 -> 部署/安全/维护。
  • 强调输出契约:说明假设、所需工具和版本、实现步骤、按证明阶段划分的测试/证据、已知限制以及恢复/安全说明。

使用方式

首先阅读 ../../docs/arduino-skill-contract.md。如果工作跨会话或涉及物理操作,embedded-project-loop 是推荐的首个技能;在实现前创建其目标/下一步待办状态,并保持打开直到证据门禁满足。填写 ../../docs/board-support/board-profile-template.md 或说明为何不需要。当必须解析命名开发板或开发板系列时,在选择引脚前加载 ../board-support/SKILL.md 及其索引档案。阅读 references/board-intake.md 进行开发板和硬件检查。阅读 references/toolchain-selection.md 了解 IDE、CLI、PlatformIO 或厂商版本与库兼容性。从路由表选择专项技能。在上传、启动、电源或固件恢复操作前阅读 references/failure-recovery.md;对于任何联网或可更新设备,阅读 references/connected-device-security.md。

适用场景

适用于组合、未充分指定或跨学科的嵌入式请求;物理或多会话请求;需要开发板与工具链路由的完整应用;电池供电 Wi-Fi 传感器、Uno R4 WiFi 上传事件、机器人控制器、多板传感器库、四按钮 ESP32 控制器等组合工作流。

限制

不要臆造引脚、电压、电流限制、内存大小、外设、协议、库版本或上传命令。询问缺失值,或使用明确标注的假设和验证步骤继续。记录确切的开发板、框架、工具链、主机、依赖版本和期望的证明阶段。不要将路由表中的一行视为技能已运行的证明。报告实际使用了哪些技能、它们产生了哪些工件,以及哪些证据阶段仍未验证。不要同时加载 arduino-serial-monitor 和第二个串口调试技能;现有串口监视器拥有结构化运行时证据。当仓库选择 PlatformIO 或原生 SDK 时,embedded-build-workflow 拥有构建录入;不要默认将原生 app_main、Zephyr、Pico SDK 或 Rust 项目路由到 Arduino CLI。