程序员用 AI 写科普文章：提示词与科普示例

每天写业务代码、修线上问题、参加评审的后端或全栈开发，日常工作里真正写代码的时间常被排查问题、写文档和同步进度挤占，很多重复性的文字和样板代码其实可以交给 AI 起草。专业的人往往最难写好科普，因为很难判断普通读者哪里会听不懂。本文给出程序员用 AI 写科普文章的一套可直接照抄的做法：先把专业要点交给 AI，让它改写成通俗版本并标出可能的误解点，再由你逐句核对专业准确性。

典型场景

程序员想围绕“订单服务从单体拆分为微服务”写一篇面向普通读者的科普文章，帮助业务方同事理解一些常见问题。专业内容自己很熟，但写出来总是术语太多、读者看不下去。而且程序员手上通常同时压着“整理缓存方案技术文档”之类的事情，如果每次都从零开始，很容易顾此失彼。

工具选择

ChatGPT、Claude、Kimi、通义千问等对话助手都适合把专业内容通俗化；配图可以用图像生成工具或示意图工具制作。

一个虚构的例子

下面这个例子是虚构的：小王遇到的难题是“依赖的第三方支付 SDK 下周升级，可能需要适配”。为了不让它拖慢“补齐用户模块的单元测试”的进度，小王决定借助 AI 写科普文章。第一次只写了一句简单的要求，结果很空泛；第二次把对象（技术负责人）、目的和限制条件都写清楚，输出就可用多了。这也是本文提示词模板要把背景写全的原因。

分步操作

列出你想传达的 3-5 个核心知识点
说明目标读者的知识水平和常见误解
让 AI 写出通俗版本，多用比喻和例子
请一位非专业的朋友试读，看哪里还看不懂

提示词示例

下面的提示词可以直接复制，按程序员的实际情况替换细节：

【背景】身份：每天写业务代码、修线上问题、参加评审的后端或全栈开发；平时主要和业务方同事和技术负责人打交道。
我是程序员，想写一篇面向普通读者的科普文章，主题与“订单服务从单体拆分为微服务”有关。

核心知识点（由我提供，请不要添加我没提供的专业结论）：
1. （知识点一）
2. （知识点二）
3. （知识点三）

读者：没有专业背景的业务方同事
要求：
1. 1200 字左右，标题要有吸引力但不夸张
2. 每个知识点配一个生活化的比喻或例子
3. 单独列出“常见误区”
4. 结尾提醒读者遇到具体问题时应咨询专业人士
5. 标出你在改写中简化了的地方，方便我核对

示例输出（仅供示意）

以下是一段示意性的输出，内容基于虚构的工作记录，仅用于展示格式和思路，实际结果会因工具和输入不同而变化：

标题：关于订单服务从单体拆分为微服务，你可能一直理解错了的三件事
开头：很多人都有过这样的疑问……（引出话题）
知识点一：用一个比喻来理解——这就像……
常见误区
误区一：……
误区二：……
结尾：每个人的情况不同，遇到具体问题，请咨询专业人士。
简化说明：第二部分把一个复杂的过程简化成了“三步”，实际情况中可能有例外，请核对。

拿到类似的结果后，小王的做法是先核对事实和数字，再结合“上线订单服务灰度”的安排调整重点，最后才对外使用。

实用技巧与常见坑

过度简化可能导致错误，让 AI 标出简化之处便于核对。
不要引用 AI 给出的研究和统计数字，除非你核实过原始出处。
标题不要用恐吓式、夸大式的表述。

给程序员的特别提醒

让 AI 先解释思路再给代码，便于你判断方向对不对。还有一点很关键：AI 生成的代码必须经过本地运行、测试和代码评审，不要直接合入主干。

举一反三

问答式科普：把读者最常问的 10 个问题整理成问答。
短视频科普：把文章改成 60 秒口播稿。