AI 提示词工作流

这一章不是让 AI 替你学，而是让 AI 像助教一样帮你把想法拆成能运行、能验证、能排错的小步骤。

AI 不能替代你理解硬件，但能显著降低“从想法到第一个 demo”的摩擦。好的提示词应该给出目标、硬件、约束、期望现象和验证方式。

直觉

对嵌入式来说，提示词里的硬件信息就是上下文。你没有说明开发板、外设、电压、接线和 ESP-IDF 版本，AI 就只能猜；猜出来的代码经常无法直接运行。

准备工作

先准备好开发板型号、ESP-IDF 版本、外设名称、接线表、目标现象和当前日志。遇到编译错误时，把完整错误贴给 AI；遇到运行错误时，把串口日志和实际现象一起贴上。

最小模板

我正在使用 ESP32 和 ESP-IDF，开发环境是 Windows。
硬件：开发板型号是 ...，外设是 ...，接线是 ...
目标：我想实现 ...
约束：请使用 ESP-IDF 官方 API，不要使用 Arduino；敏感信息通过 menuconfig 配置。
输出：请先给思路和任务划分，再给完整工程文件，最后给验证步骤和常见错误。

复杂 demo 不要直接让 AI 写完整代码。更稳的做法是先让它画模块关系，再生成最小可运行版本，最后用编译错误和串口日志迭代。

常见错误

AI 生成代码必须审查：是否硬编码 Wi-Fi 密码、是否使用过时 API、是否缺少错误检查、是否把耗时操作放进中断回调、是否无限制分配内存或保存 HTTP 响应。

本章提示词

请把我的嵌入式需求改写成高质量 AI 提示词。要求包含硬件型号、ESP-IDF 版本、接线、目标现象、隐私约束、输出格式、验证步骤和代码审查清单，并提醒我哪些信息不能贴给 AI。