SuperAPI AI 工具集

embedded-build-workflow

编程与开发

查看项目

更新于 10-16 06:44

技能介绍

用途:检查、复现或迁移嵌入式构建工作流,覆盖 PlatformIO、原生 ESP-IDF、Arduino CLI、Zephyr/west、Pico SDK、STM32Cube 与 MicroPython。核心原则是框架名称不等于目标支持或构建成功,需产出明确的项目/环境矩阵与最小可复现构建路径。

主要能力:先读取共享契约,保留源码位置与既有固定版本工具链,再提出迁移。运行离线检查器:uv run scripts/inspect_build.py --project PATH。该检查器不构建、不烧录、不打开端口、不安装包、不执行项目脚本,返回参数数组而非 shell 命令;自定义构建脚本需先审查再另行授权构建。按检测到的框架读取工具链分支,选择仓库自身的构建管理器而非 Arduino 默认。若 PlatformIO 含 extra_configs、extends 或插值,需获取其原生计算配置,未解析前保持未解析状态;含凭据的原始计算配置不得共享。

记录内容:板卡/载板版本、模块后缀、flash 与 PSRAM 分开记录、环境、宿主 OS、工具版本与依赖解析。ESP32-S3 内存工作需读取内存证据,仅在明确物理配置与所选生成 sdkconfig 来源时使用 scripts/check_memory_config.py。构建范围内每个声明的程序/环境;无构建路径的输入程序应报告,不推断每个 sketch 都需要同级 INI。CI 中复用同一矩阵。

迁移分阶段:基线构建、有界 API/驱动适配、宿主测试、原生构建、授权目标测试。Arduino 库可能依赖原生不可用的 Wire、时序、回调与运行时初始化。报告检查证据与未验证阶段,使用支持矩阵而非系列徽章。

输出:项目路径;所有声明环境;框架与管理器;明确版本、未解析继承与自定义脚本信任边界;构建/测试参数数组与实际结果(授权执行时);四种内存结论:confirmed-mismatch、consistent-with-inspected-evidence、unresolved、not-applicable;源码版本/输入哈希、所选环境与产物标识;上传、物理内存配置与运行时行为标记为未验证。

归属:工作流路由保留板卡/接线/应用组合工作;arduino-cli-skill 负责 Arduino CLI 命令,原生项目留在此处;board-support 解析板卡身份,本技能检查构建配置;realtime-control-design、freertos-patterns 与 wireless-telemetry 各自负责其设计;引脚与电气声明不进入检查器。

验证:辅助工具使用 Python 标准库,在包根运行 uv run -m unittest discover -s tests -p test_embedded_workflows.py。辅助工具测试证明其输出与不确定性处理,不证明固件构建;声称构建证明前需单独运行可信编译夹具。具体原生机制使用对应专家:Zephyr、STM32Cube、Pico SDK、MicroPython。Rust 不在当前实现范围。