编写高质量提示词

高质量提示词不是更长，而是更明确。它应该让 Probes 知道目标、上下文、允许动作和验证标准。

推荐结构

我想完成什么：
当前观察到什么：
相关文件或日志：
你可以做什么：
请先不要做什么：
什么结果算成功：

这个结构能避免 Probes 过早扩大范围，也能让后续修改和验证更容易复盘。

示例：分析优先

我想定位 USART1 没有输出日志的原因。
当前现象是烧录后串口没有任何输出，波特率 115200 8N1。
请先查看启动文件、时钟初始化、GPIO 和 USART1 初始化代码。
这一轮只分析原因和下一步验证命令，不要修改代码。
成功标准：给出最可能的 1 到 3 个原因，并说明每个原因如何验证。

示例：允许闭环修改

请帮我修复 I2C1 扫描不到 OLED 的问题。
你可以读取并修改相关驱动代码，可以运行构建。
请优先检查 PB6/PB7 复用、I2C 时钟、上拉假设和 OLED 地址。
修改后请说明改动文件、构建结果和下一步硬件验证方式。
成功标准：构建通过，并给出能验证 OLED ACK 的最小步骤。

常见问题

写法	问题	更好的写法
帮我看看为什么不行	范围太大，没有目标	请定位 cmake --build build 的链接错误
修好这块板子	结果不可验证	先让串口 boot 日志恢复输出
你随便改	风险太高	只修改 USART 初始化相关文件
看完整个项目	噪声太多	先看 firmware/Core 和 Drivers/Platform

什么时候用完整模板

当问题涉及代码修改、构建、烧录和调试验证时，可以使用 嵌入式智能体提示词示例 中的完整模板。普通分析任务不需要那么长。