mcpField
A
arduino-project-builder

arduino-project-builder

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

关于 arduino-project-builder

根据需求组装完整 Arduino 项目的技能，提供脚手架命令行工具和多种项目示例。它指导架构、实现与验证，并区分生成代码和硬件验证。

主要功能

  1. 01命令行项目脚手架
  2. 02环境监测、机器人与 IoT 示例
  3. 03需求收集与开发板配置
  4. 04架构设计和代码组装指导
  5. 05区分构建与硬件证据
  6. 06验证及文档检查清单

适用场景

  1. 01搭建 ESP32 气象站
  2. 02创建 Uno 机器人控制器
  3. 03规划带远程监控的 IoT 设备
  4. 04交付前检查验证证据

安装

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

$npx skills add https://github.com/wedsamuel1230/arduino-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