很多人在使用妙鸭文档AI时都遇到过这种情况：明明想让AI把知识库里的技术文章改写为面向新人的教程，可它根本不经过判断就直接开始输出，结果缺少新手视角，基础概念被遗漏，步骤顺序也混乱不堪。问题的根源在于——必须强制AI先分析原文结构、确认读者的认知水平、补全教学逻辑中的缺口，然后再动笔生成。

第一步：用结构化指令锁定AI的思考路径

在提示词的最开头，明确写出一段三段式指令，告诉AI必须严格执行——而不是“建议”或“考虑”。推荐写法如下：

「请严格按以下顺序执行：① 通读全文，标注原文中未定义的专业术语（如“OAuth2.0”“幂等性”）；② 判断目标读者是否具备该术语前置知识（默认不具备，除非原文已作解释）；③ 基于判断结果，在教程对应位置插入1句话定义+1个生活类比（例：“幂等性就像电梯按钮——按1次或按5次，最终都只上到8楼”）。完成三步判断后，再开始改写。」

这一步——序号和“严格按以下顺序”这组关键词——一个都不能少。否则AI会直接跳过判断阶段，默认你已经把一切交给它处理。它只认显式的指令标记，忽略软性的引导语。

第二步：用分隔符隔离判断区与输出区

在提示词中插入一个清晰的分隔线

「请将你的全部判断过程（含术语列表、认知缺口分析、类比建议）写在

为什么必须用物理分隔？因为如果只是口头要求“请分两步走”，AI大概率会把判断混在教程段落里，最后新人看到的不是干净教程，而是“注意：此处原文未解释Redis”这类元信息——非常干扰阅读。物理隔离就是强迫AI在“分析模式”和“生成模式”之间切换，互不干扰。

第三步：给AI一个不可跳过的“判断确认”开关

有两种方法，推荐混合使用。

方法一：要求AI在开始改写前，先输出固定格式确认句
→ 「判断完成：共发现3个未定义术语（JWT、熔断器、Saga模式），全部需补充基础解释。」

方法二：在提示词末尾加一句硬性条件
→ 「如果未输出上述确认句，则整篇教程视为无效，必须重来。」

妙鸭文档AI对“必须重来”这句话的响应非常积极——它会当作一条不可违背的硬约束。而“请确保”“建议”这类软性措辞，它通常直接忽略。所以这个开关的关键就在于：用明确的后果描述锁死AI的跳步冲动。

总结一下：要想让AI写出合格的新人教程，本质是替它设计一套不能绕开的思考工序。结构化指令、物理分隔符、不可跳过的确认开关——这三步配合使用，就能把AI从“凭直觉写”变成“按流程分析再生成”。