实验 06 · 32 分钟 · 入门

做一页讲清一个概念

把一份长资料变成有问题、解释、例子和行动建议的知识单页。

本课产物
one-page-explainer.html
学习方式
边做边检查

完成后你能

本课目标

  • 从资料中提炼一个核心问题
  • 建立不超过三级的信息层级
  • 区分事实、类比与个人建议

开始前

准备这些

  • 新建 06-one-page-explainer 文件夹
  • 准备一份你有权使用的资料或自己的学习笔记
  • 记录资料标题、作者与原始链接

01 · 把主题缩成一个问题

“介绍大模型”太大。选择一个读者会真正问的问题,例如“上下文窗口为什么不是无限记忆?”单页只能答清一个核心问题。

先从资料中提取五条事实,每条旁边记录来源位置;再写一个日常类比,并明确标注类比只是帮助理解。

  1. 写出目标读者:完全没接触过概念的人,还是已有基础的人。
  2. 写一个问句式标题。
  3. 筛选五条直接支持问题的事实,删除旁支知识。
  4. 为每条事实保留来源链接或章节位置。

02 · 用四段叙事结构

层级越深,读者越容易迷路。整页使用一个 h1,四个主章节用 h2;只有确实需要分组时才使用 h3。

示例
1. 一句话答案:首屏直接回答问题
2. 它如何工作:只保留 3 个关键环节
3. 一个具体例子:输入 → 发生什么 → 结果
4. 你可以怎么做:给读者 3 条行动建议

03 · 让 Agent 忠于材料

把资料边界直接写进 Prompt。Agent 遇到证据缺口时应报告缺口,而不是用听起来合理的内容填满页面。

复制给 Agent
请在 06-one-page-explainer 中创建 one-page-explainer.html,主题是「[你的问题]」。

只能使用我接下来提供的笔记,不要补写未经材料支持的事实。页面结构:一句话答案、三个关键环节、一个具体例子、三条行动建议、来源区。
请把“材料事实”“帮助理解的类比”“我的建议”用清楚的文字标签区分。每条事实旁使用 [1][2] 形式标记来源,页尾列完整标题与链接。正文层级不超过 h3;首屏在 390px 下也能看到一句话答案。

如果材料不足以支持某个结论,直接写“现有材料不足”,并在生成页面前列出缺口。

04 · 做删减式审稿

知识单页的质量常常来自删除。逐段问:删掉它,读者还能回答核心问题吗?如果能,它可能只是背景噪音。

  1. 只看首屏,确认问题和一句话答案同时出现。
  2. 检查每条带数字或定义的事实是否能追到来源。
  3. 把所有“显然、一定、彻底”等绝对词圈出,逐一判断证据。
  4. 删除至少一个不服务核心问题的段落。
复制给 Agent
请对页面做一次“删减审稿”。核心问题是「[你的问题]」。列出三个可以删除或合并的段落,说明它们为什么不直接服务核心问题。不要直接修改,等我选择。

不要跳过

完成检查

逐项在真实页面中验证。勾选状态只保存在这台设备的浏览器中。

0 / 6 已完成

常见错误

卡住时先看这里

让 Agent 自己补齐资料
限定只使用提供材料;缺口必须显式报告。
用类比代替事实
类比单独标注,并紧跟真实机制说明。
每段都很重要
围绕一个核心问题做删减测试。

可选加练

再多走一步

邀请目标读者阅读两分钟,让他写下一句话答案;与页面首屏答案比较。