mcpField
A
arduino-project-builder

arduino-project-builder

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

关于 arduino-project-builder

arduino-project-builder 是根据需求组装 Arduino 项目的技能，可组合传感器、执行器、状态机、日志和通信等模式。它为支持的开发板生成项目脚手架，并区分生成结果与硬件验证证据。

主要功能

  1. 01按需求组装项目
  2. 02生成 PlatformIO 项目文件
  3. 03支持环境监测、机器人和 IoT 设计
  4. 04记录开发板与工具链约束
  5. 05区分构建与硬件证据

适用场景

  1. 01启动环境监测项目
  2. 02创建机器人控制器脚手架
  3. 03规划带 WiFi 或 MQTT 的 IoT 设备
  4. 04记录开发板要求与验证情况

安装

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

$npx skills add https://github.com/wedsamuel1230/embedded-engineering-skills --skill arduino-project-builder

安装后在 Claude Code 中输入/arduino-project-builder确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

assets/
workflow.mmd
examples/
project-environmental-monitor.md
project-iot-device.md
project-robot-controller.md
references/
project-environmental-monitor.md
project-iot-device.md
project-robot-controller.md
rules/
board-considerations.md
integration-checklist.md
quality-standards.md
scripts/
scaffold_project.py
templates/
project-output-template.md
workflow/
step1-requirements-gathering.md
step2-architecture-design.md
step3-code-assembly.md
step4-testing-validation.md
step5-documentation.md

详细介绍

Arduino 项目构建器

根据需求组装完整、可用的 Arduino 项目。此技能将多种模式（传感器、执行器、状态机、日志记录、通信）组合为紧密协作的系统。

快速开始

列出可用的项目类型：

uv run --no-project scripts/scaffold_project.py --list

创建一个完整的项目：

uv run --no-project scripts/scaffold_project.py --type environmental --board esp32 --name "WeatherStation"
uv run --no-project scripts/scaffold_project.py --type robot --board uno --output ./my-robot

交互模式：

uv run --no-project scripts/scaffold_project.py --interactive

需求获取与证据边界

在组装项目之前，请阅读共享契约 并填写开发板配置。 记录确切的开发板、框架、工具链、版本、引脚、内存、电源、 协议和恢复路径。将构建、上传、硬件、系统和 部署证明分开；生成的脚手架不是硬件验证。

脚手架脚本会输出其支持的开发板目标和 PlatformIO 结构。 对于其他开发板或厂商框架，复用需求与架构 工作流，然后提供特定于工具链的实现，而不是更改 脚本声称的支持范围。

资源

  • examples/ - 完整的项目示例（环境监测器、机器人控制器、IoT 设备）
  • scripts/scaffold_project.py - 用于项目脚手架的 CLI 工具（config.h、main.ino、platformio.ini、README）
  • assets/workflow.mmd - 项目组装工作流的 Mermaid 图

支持的项目类型

环境监测器

多传感器数据记录器（温度、湿度、光照、空气质量）

参见环境监测器示例

机器人控制器

电机控制、传感器融合、避障、状态机

参见机器人控制器示例

IoT 设备

WiFi/MQTT 数据传输、云集成、远程监控

参见IoT 设备示例

家庭自动化

继电器控制、计划任务、传感器触发操作

数据采集系统

高频采样、SD 卡记录、实时可视化

项目组装工作流

  • 需求获取 - 分析用户请求并收集项目规格
  • 架构设计 - 设计组件连接、数据流和状态机
  • 代码组装 - 组合模式并针对用户硬件进行定制
  • 测试与验证 - 验证编译、内存使用和功能
  • 文档 - 创建接线图、使用说明和故障排除指南

质量标准与规则

项目输出模板

  • 输出模板 - 交付完整 Arduino 项目的标准化格式

资源

  • examples/ - 包含完整实现的完整项目示例
  • scripts/scaffold_project.py - 用于项目脚手架的 CLI 工具，包含 config.h、main.ino、platformio.ini、README
  • assets/workflow.mmd - 项目组装工作流的 Mermaid 图
  • workflow/ - 分步项目组装流程
  • rules/ - 质量标准和特定于开发板的优化
  • templates/ - 项目输出模板和文档标准

共享输出契约

使用共享 Arduino 技能契约： 说明假设、所需工具与版本、实现步骤、 按证明阶段划分的测试/证据、已知限制，以及恢复/安全注意事项。

评论

支持 Markdown