知识型文章和产品说明最常见的三个问题是:
- 读者不理解某个概念
- 读者不相信你的判断
- 读者心里还有疑问
definition、tweet、question 分别解决这三个问题。
它们的共同目标是降低理解成本。
三个模块的分工
definition:解释一个术语或概念。tweet:引用一条用户反馈或社交证明。question:整理读者可能会问的问题。
如果一篇文章要让读者更快理解、更愿意相信、更少犹豫,这三个模块非常值得放进中段。
definition:让术语不再打断阅读
当你必须使用专业词时,不要在正文里绕很长一段解释。
:::definition
{"term":"GEO","def":"Generative Engine Optimization,面向 AI 搜索和 AI 答案引擎的内容优化方式,重点是让内容更容易被理解、引用和推荐。"}
:::
适合:
- 技术术语
- 方法论名词
- 产品概念
- 行业缩写
注意:
- 只解释一个概念
- 不要写成百科长文
- 最好用一句话讲清楚它和读者有什么关系
tweet:把真实反馈变成信任证据
tweet 不一定只用于推文。它本质上是“短反馈引用卡”。
:::tweet
{"name":"一位内容团队负责人","handle":"@content-lead","text":"以前每篇公众号都要反复调样式,现在只要先定模块结构,文章看起来稳定很多。","timestamp":"2026-06-03"}
:::
适合:
- 用户反馈
- 社交媒体摘录
- 客户评价
- 社群评论
- 内部复盘金句
注意:
- 不要伪造来源
- 不要写得像广告语
- 反馈越具体越可信
question:把疑问集中处理
如果读者读到一半会犹豫,可以提前用 question 承接。
:::question
Q: 这些模块需要懂设计才能用吗?
A: 不需要。你只需要判断内容属于开场、证据、说明还是行动,再选择对应模块。
Q: 模块越多文章越高级吗?
A: 不是。模块应该解决阅读问题,连续堆叠只会让文章更累。
:::
适合:
- FAQ
- 课程介绍
- 产品说明
- 服务介绍
- 读者疑虑
三个模块怎么放进一篇文章
教程文章
推荐顺序:
definition解释新概念question回答初学者疑问resource-list放延伸资料
产品文章
推荐顺序:
definition解释产品能力tweet放真实反馈question回答购买前顾虑
观点文章
推荐顺序:
definition限定讨论范围tweet引用外部反馈quote-card提炼核心判断
结构化写法注意事项
这三个模块都偏结构化,但输入位置不同:definition 和 tweet 使用标准 JSON;question 只使用大写 Q: / A: 成对文本。
最常见错误有三类:
- 字符串缺少引号
- 数组结尾多逗号
question使用了小写前缀,或问题与回答没有成对出现
给 Agent 的提示词可以这样写:
请用合法 JSON 输出 definition 和 tweet 模块,字段名使用英文双引号。
question 模块只写一组或多组大写 Q: / A:,不输出 JSON。
不要混用两种输入位置。
常见错法
把 definition 写成小论文
术语卡只负责“让读者继续读下去”,不是负责讲完全部背景。
把 tweet 写成品牌广告
可信反馈应该具体、有场景、有人的语气。
把 question 放到文章最后才出现
如果疑问会影响读者继续阅读,就应该提前出现,不一定等到结尾。
下一步
如果你要做方案选型、版本更新或资源合集,可以继续读: