技术科普写作的“四维模型”,附 Prompt 模板
🛡️ 第一维度:场景构建(Scenario & Logic)
——拒绝生硬比喻,追求逻辑闭环
真实性原则:比喻必须基于大众熟悉的真实生活逻辑,不能为了比喻而比喻。
反面教材:把路由器比作大门,却又说要绕过大门走窗户(逻辑不通)。
正面教材:把局域网比作办公室,Mac 是唯一有专线的专员,其他人必须委托他办事(符合代理 Proxy 的本质)。
统一性原则(逻辑闭环):一个比喻要贯穿全文,不能中途跳戏。
如果开头设定是“办公室”,中间就不要突然变成“机场”或“高速公路”。
所有的技术动作(如配置端口、查 IP),都必须在这个故事里找到对应的行为(如放收纳筐、查工位号)。
🛠️ 第二维度:技术深度(Technical Depth)
——拒绝避重就轻,追求词源级解释
严肃性原则:不要为了迎合小白而阉割核心技术手段。
如果修改配置文件(YAML)和命令行(Terminal)是解决问题最稳妥的方式,那就保留它,不要用不稳定的图形界面开关去糊弄。
解码原则(知其所以然):必须解释技术名词背后的含义,特别是词源。
Don't just say:输入
grep。Say:
grep是 Global Regular Expression Print(全局搜索),它的作用是在茫茫数据中精准抓取我们要的那一行。Don't just say:填
0.0.0.0。Say:
0.0.0.0代表“全接口监听”,意思是让电脑摘下耳机,不再只听自己的,而是监听全网段。
🧩 第三维度:细节完备(Completeness)
——拒绝思维跳跃,追求落地执行
路径完整性:不要假设用户知道“终端”在哪里,不要假设用户知道怎么看 IP。
每一个操作都要有清晰的路径指引(如:设置 -> 网络 -> 详情)。
验证思维(排错闭环):文章不能停在“配置完”这一步,必须给出“如何验证是否成功”的方法。
教用户像开发者一样去查岗(Check),而不是盲目地试错(Try)。
🎨 第四维度:可读性设计(Visual Structure)
——拒绝文字堆砌,追求视觉降噪
模块化排版:
表格(Tables):用于“代码 vs 人话”的强对比,这是降维打击最有效的工具。
引用块(Blockquotes):专门用来承载“场景故事”或“核心概念”,与操作步骤区隔开。
代码块(Code Blocks):通过颜色高亮,清晰展示需要复制的内容。
视觉锚点:
善用 Emoji(🏠, 🚪, 💻, 👂)作为视觉索引,帮助读者快速定位当前是在讲原理还是在讲实操。
🚀 通用 Prompt 模板(可复用)
## 任务目标
撰写一篇面向大众/小白用户的技术科普教程,主题是:[填写主题,如:Mac局域网代理共享]。
## 核心要求(必须严格遵守)
1. **场景化叙事(逻辑闭环)**:
* 必须构建一个贴切的现实生活比喻(如办公室、物流、传达室等),且该比喻必须能完整映射技术原理的全流程。
* 严禁中途更换比喻,严禁逻辑不通的生硬类比。
2. **技术严肃性与深度**:
* 保留最稳妥的技术解法(即使包含命令行或改代码),不要为了简化而牺牲稳定性。
* **关键概念必须解释**:对出现的每一个技术参数(如 IP, Port, 0.0.0.0)和命令(如 netstat, grep),必须进行“词源级”或“底层逻辑级”的解释,告诉用户“为什么要这么做”。
3. **可读性与排版**:
* 使用 Markdown 结构化排版。
* **强制使用表格**:用来对比“技术代码”与“人话含义”。
* **视觉分层**:用引用块(>)包裹比喻故事,用代码块包裹命令。
* 适当使用 Emoji 增加视觉锚点。
4. **完整性与排错**:
* 步骤必须包含具体路径(点击哪里打开)。
* 必须包含“验证与排错”章节,教用户如何通过客观数据(如命令行状态)来判断是否成功,而不是盲目测试。
## 语气风格
* 平实、专业但有亲和力。
* 像一个耐心的技术专家在教普通朋友,既不傲慢也不把对方当傻瓜。