Karl Wonders

Karl 在想什么呢

技术科普写作的“四维模型”,附 Prompt 模板

3
2026-01-04

🛡️ 第一维度:场景构建(Scenario & Logic)

——拒绝生硬比喻,追求逻辑闭环

  • 真实性原则:比喻必须基于大众熟悉的真实生活逻辑,不能为了比喻而比喻。

    • 反面教材:把路由器比作大门,却又说要绕过大门走窗户(逻辑不通)。

    • 正面教材:把局域网比作办公室,Mac 是唯一有专线的专员,其他人必须委托他办事(符合代理 Proxy 的本质)。

  • 统一性原则(逻辑闭环):一个比喻要贯穿全文,不能中途跳戏。

    • 如果开头设定是“办公室”,中间就不要突然变成“机场”或“高速公路”。

    • 所有的技术动作(如配置端口、查 IP),都必须在这个故事里找到对应的行为(如放收纳筐、查工位号)。

🛠️ 第二维度:技术深度(Technical Depth)

——拒绝避重就轻,追求词源级解释

  • 严肃性原则不要为了迎合小白而阉割核心技术手段

    • 如果修改配置文件(YAML)和命令行(Terminal)是解决问题最稳妥的方式,那就保留它,不要用不稳定的图形界面开关去糊弄。

  • 解码原则(知其所以然):必须解释技术名词背后的含义,特别是词源

    • Don't just say:输入 grep

    • Saygrep 是 Global Regular Expression Print(全局搜索),它的作用是在茫茫数据中精准抓取我们要的那一行。

    • Don't just say:填 0.0.0.0

    • Say0.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.  **完整性与排错**:
    * 步骤必须包含具体路径(点击哪里打开)。
    * 必须包含“验证与排错”章节,教用户如何通过客观数据(如命令行状态)来判断是否成功,而不是盲目测试。

## 语气风格
* 平实、专业但有亲和力。
* 像一个耐心的技术专家在教普通朋友,既不傲慢也不把对方当傻瓜。