AI驱动嵌入式开发-Harness-Engineering实践指南

给 AI 配上锤子和螺丝刀嵌入式 AI 辅助开发的 Harness Engineering 实践让 AI 写代码并不难难的是让 AI 自己验证代码。这篇文章以 STM32F103C8T6 WS2812 项目为载体记录了如何通过搭建 Harness工具资料权限让 AI 从代码生成器变成自主开发者。关联文章STM32命令行工具链手册-编译烧录调试自动化指南WS2812驱动开发与调试经验总结一、理念转变从AI 帮我写代码到给 AI 配工具1.1 两种开发模式对比传统模式AI 作为代码生成器用户描述需求 → AI 生成代码 → 人工复制 → 手动编译 → 发现错误 → 再次询问 AI → ...问题AI 无法验证代码是否正确编译错误需要人工反馈调试信息 AI 看不到每次沟通都从零开始Harness 模式AI 作为自主开发者搭建环境 → 提供 Harness工具资料权限→ AI 自主完成编码 → 编译 → 调试 → 修复 → 验证优势AI 可以自主验证代码编译错误 AI 自己读取并修复调试信息 AI 可以自主获取形成闭环快速迭代1.2 本项目的选择本项目采用了Harness 模式。整个开发过程的核心不是让 AI 写代码而是先搭建一套让 AI 能自主工作的环境。二、Harness Engineering 实践2.1 什么是 HarnessHarness工具套件是 AI 自主工作的基础设施包含三个要素要素内容作用工具编译器、烧录器、调试器、串口监视器AI 可以执行操作、获取反馈资料数据手册、参考工程、协议文档AI 基于权威信息工作而非凭空猜测权限文件读写、命令执行、网络访问AI 可以自主操作无需人工介入2.2 实践一编译烧录工具链为什么先做这个让 AI 能自主验证代码搭建过程分析项目结构发现 EIDE 扩展自带命令行工具探索工具可用性检查 ~/.eide/tools/ ├── gcc_arm/ ✓ ARM GCC 工具链 ├── jlink/ ✓ J-Link V8.50 └── openocd/ ✓ OpenOCD 备选解决环境兼容性问题问题解决方案Batch 脚本在 Bash 中失败编写原生.sh脚本J-Link 不识别 Unix 路径sed 路径转换Glob 搜索超时缩小范围 Bash 循环脚本移动后路径错误修正相对路径层级封装为 Skill.claude/skills/eide-stm32-dev/ ├── SKILL.md # Skill 定义 └── scripts/ ├── build-flash.sh # 编译 烧录 ├── clean.sh # 清理 └── debug.sh # 调试效果AI 可以自己编译 → 看报错 → 修复 → 重试无需人工介入实际案例光效系统开发中AI 在 3 次编译迭代内完成修复按键宏未定义错误修复枚举类型混用警告修复正弦表初始化警告最终达成零警告、零错误。2.3 实践二参考资料供给为什么重要AI 基于资料理解协议而非凭空生成供给方式资料类型内容作用协议文档WS2812相关信息.md理解 NRZ 协议、时序参数参考工程WS2812参考工程分析.md对比配置差异PCB 连接表PCB连接关系表.md确认引脚映射实际效果驱动开发少走弯路AI 知道 GRB 顺序、800kHz 频率问题定位更精准对比参考工程发现 DMA 触发方式差异避免硬件踩坑PCB 连接表防止引脚配置错误反面案例最初未提供 PCB 连接表时AI 根据常规配置猜测引脚结果LED 引脚猜错 3/4OLED I2C 引脚配置错误蜂鸣器引脚不对教训硬件相关的信息必须明确提供AI 无法猜对 PCB 设计。2.4 实践三调试能力扩展串口监视器python tools/serial_monitor.py COM8115200-rAI 可以实时读取设备输出看到调试打印信息验证程序运行状态GDB 调试AI 可以设置断点读取寄存器查看调用栈分析内存内容实际案例WS2812 渐变色问题排查中AI 通过串口打印 PWM 缓冲区确认编码正确定位到传输层问题。三、Superpowers 工作流实践Superpowers是 Claude Code 的一套结构化技能系统skill提供 brainstorming、writing-plans、code-review 等工作流模板。它不是本项目专用的工具而是 Claude Code 生态中的通用能力。这里记录的是它在嵌入式场景下的实际应用效果。3.1 工作流概览Superpowers 是一套结构化的开发工作流确保想清楚再做阶段工作流作用设计brainstorming逐层澄清需求避免返工规划writing-plans分解任务识别风险执行executing-plans按计划实施质量可控审查code-review捕获问题保证质量3.2 游戏设计brainstorming 实践场景设计消消乐游戏过程brainstorming 工作流通过一次一个问题的方式逐步澄清布局方案单向布局 vs 双向布局选择单向布局玩家区 0-2轨道 3-56敌方区 57-59炮弹设计单灯还是多灯选择多灯带拖尾效果碰撞规则颜色不匹配怎么处理选择不扣命只消耗玩家炮弹按键映射游戏中按键功能选择KEY1/2/3 发射KEY4 暂停难度系统如何递进选择波次递进 动态平衡效果从模糊想法到精确设计避免后期返工对比如果没有 brainstorming可能的问题做到一半发现布局不合理碰撞规则需要推翻重来按键功能冲突3.3 光效系统planner code-review 实践planner 使用AI 自动生成实现计划模块化设计分离颜色工具和光效逻辑文件架构WS2812_ColorUtilsWS2812_Effects实现步骤按优先级分阶段code-review 使用每次代码变更后AI 自动审查类型安全代码规范潜在问题实际捕获的问题volatile 遗漏中断共享变量缓冲区溢出风险vsprintf→vsnprintf枚举类型混用警告3.4 驱动调试investigate 自主迭代WS2812 渐变色问题现象设置全红显示渐变色investigate 排查数据层打印颜色缓冲区 ✓ 正确编码层打印 PWM 缓冲区 ✓ 正确传输层检查 DMA 配置 →发现 CC2 触发问题自主迭代尝试 1内存对齐 → 无效 尝试 2增加复位周期 → 无效 尝试 3修改 DMA 触发方式 → 解决验证编译 → 烧录 → 串口确认 → 成功整个过程 AI 自主完成无需人工介入。四、效率对比以下对比仅衡量单次操作耗时不包含 AI 思考和生成代码的时间。AI 生成代码的时间取决于任务复杂度通常在数秒到数十秒之间。4.1 传统嵌入式开发操作方式耗时编译手动点击按钮~10s含操作烧录手动操作 J-Link~30s查看输出眼睛盯着串口助手持续定位问题人工分析分钟级修复验证重新编译烧录~1min一个问题的典型周期2-5 分钟4.2 AI Harness 开发操作方式耗时编译AI 自主调用脚本~2s烧录AI 自主执行~0.5s查看输出AI 读取串口数据即时定位问题AI 分析错误信息秒级修复验证AI 自动重试~3s一个问题的典型周期5-10 秒4.3 量化收益指标传统方式AI Harness提升编译周期~10s~2s5x问题定位分钟级秒级10x迭代速度分钟/次秒/次10x人工介入必须可选-实际案例光效系统开发3 次编译迭代完成总耗时 1 分钟五、方法论沉淀5.1 Harness 三要素Harness 工具 资料 权限要素检查项工具编译器、烧录器、调试器、监视器是否可用资料数据手册、参考代码、硬件文档是否提供权限文件读写、命令执行、网络访问是否开放5.2 工作流选择指南场景推荐工作流新功能设计brainstorming → writing-plans → executing-plansBug 修复investigate → fix → verify代码变更code-review 质量保障复杂重构writing-plans 先规划5.3 可迁移到其他项目的经验1. 先搭环境再写代码不要急着让 AI 生成代码。先问AI 能编译吗AI 能烧录吗AI 能调试吗如果答案是否定的先把这些问题解决。2. 提供权威资料不要让 AI 凭记忆或猜测。提供数据手册协议、时序、寄存器参考工程可直接对比硬件文档引脚映射、连接关系3. 封装可复用能力把工具链封装为 Skill下次项目直接复用eide-stm32-devSkill 可用于其他 STM32 项目脚本稍作修改即可适配4. 让 AI 闭环验证AI 写完代码后让它自己编译验证烧录测试读取输出分析问题修复重试不要人工介入这个循环。六、局限性Harness 模式并非万能。以下是实践中发现的边界AI 无法处理的问题硬件层面虚焊、电源不稳、信号干扰——AI 只能分析软件和配置物理问题需要示波器和万用表环境层面USB 连接断开、驱动安装失败、操作系统兼容性——这些需要人工介入设计层面PCB 引脚分配、电源拓扑——AI 只能按提供的文档工作无法替代硬件设计决策首次搭建成本工具链脚本编写、Skill 封装、参考资料整理需要额外投入对于一次性小项目手动开发可能更快Harness 的价值在重复迭代中体现搭建一次后续项目复用AI 的常见偏差倾向于使用熟悉的库/方案可能忽略目标平台的特殊约束对实时性要求高的场景中断延迟、DMA 时序AI 可能需要多次试错才能收敛参考资料的质量直接影响 AI 的输出质量——垃圾进垃圾出仍然成立七、总结核心观点AI 是执行者不是魔法它需要工具、资料、权限才能自主工作Harness 决定 AI 的能力边界没有编译工具链AI 无法验证代码没有调试能力AI 无法定位问题工作流保证质量brainstorming 避免返工code-review 保证质量闭环是关键AI 能自主验证 → 快速迭代 → 高效开发本项目成果成果说明工具链 Skilleide-stm32-dev可复用于其他 STM32 项目WS2812 驱动PWMDMA 方案稳定驱动 60 颗 LED消消乐游戏完整游戏逻辑 光效系统方法论这篇文章可迁移到其他项目适用范围本文的方法论适用于嵌入式开发需要编译、烧录、调试工具链硬件相关项目需要提供硬件文档和引脚映射AI 辅助开发希望 AI 自主工作而非仅生成代码