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. 阅读 references/toolchain-selection.md，了解 IDE、CLI、PlatformIO 或厂商版本及库的兼容性。
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，然后使用本路由表	持久状态与用户控制的关卡

组合工作流

技能可以组合使用。每项决策只保留一个负责人，并将其产物传递给下一项技能。对于组合请求，默认按以下简明顺序执行：

loop（如果是长时间运行的工作）-> 开发板选择/信息收集 -> 接线安全 -> 库/记忆 -> 项目/代码/时序 -> 工具链构建/上传 -> 串口和硬件测试 -> 系统/校准 -> 部署/安全/维护

默认组合顺序：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 开始，并在后续阶段持续保留其下一步待办事项和证据台账。

如果用户已提供准确且受支持的开发板标识，则跳过 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 分支 -> 各开发板构建证明和 已记录的不支持行为。
• 四按钮 ESP32 控制器：开发板选择 -> 引脚分配 -> 接线 安全 -> 非阻塞消抖 -> 代码生成器 -> 构建证明 -> 硬件 关卡 -> 串口/系统证据。

不要将表格中的一行视为技能已运行的证明。请说明实际使用了哪些技能、它们生成了哪些产物，以及哪些证据阶段仍未验证。

输出约定

使用 ../../docs/arduino-skill-contract.md：说明假设、所需工具及版本、实施步骤、各证明阶段的测试/证据、已知限制，以及恢复/安全注意事项。