← 返回全部文章
方法与工具 · 2026-10-24

talk-smith 来路:把「我看过的好分享」拆成可迁移的动作

4 min read

把研究资料依次贴进文章,作者可能讲完了,读者仍不知道能用在哪。talk-smith 把技术主题做成面向读者的分享:先锁定听众和一句主线,再安排背景、机制、误区与可借鉴的动作。

核心做法:先保真,再组织叙事。给读者明确入口,讲清技术为什么这样做,亮出未做完的边界,最后留下能转述、能搬回工作的一点收获。

技术分享、实践复盘、博客、talk 和 slides 都接,对内对外、严肃无幽默都适用。普通研究报告、机制解读与选型研判仍归费曼,发布地点和幽默感不决定文体。

内容与形式

参考作者反复打磨的真实分享稿,提炼开头、主线、例子和诚实边界的动作。私人梗、口头禅、专栏配色与栏目外壳不进入通用规则,避免把“像某个人”当成分享质量。

结构流水线借过 content-research-writer 的大纲、引用和逐节反馈思路;人工质检借过 stop-slop 的分项评价与低于阈值重写思路。都按中文技术分享重定,不复制原文或作者人设。

任务与材料

开始时先用已有材料确定讲给谁、听完留下什么、选文章还是口播或分镜、场合是否严肃;缺的才问。工程实践要有现象、动作、结果与未做完的边界,不能替作者编事故或成绩。

下图展示装配关系:先吃上游研究结果,再组织分享,配图和发布都不接管正文。

装配关系图(竖版):feynman 上游 + 五步流水线 + 软依赖 + 两次基准校准

阶段交给下一步什么为什么需要
意图对齐读者、主线、文体与场合筛掉不服务这场分享的素材
技术核实有出处、条件和边界的机制与事实叙事与评分不能补救技术错误
叙事大纲五至八行推进链,先确认方向让前一节的问题引出后一节,避免填完再砍
分态写作适配文章、talk 或 slides 的初稿回看、现场听与屏幕分镜需要不同密度
检查与定稿能对回证据、没有明显阅读缺口的正文人工判内容,脚本扫字面,中文最后统一清洗

术语保留原词,关键术语给读者一句定位;机制要回到工程事实,数字带出处。已有费曼研究结果直接复用,只查新缺口。少了事实就缩范围或留未知,不给过程添剧情。

叙事推进

开头先让读者知道这事与自己有什么关系。默认 TL;DR 短卡,也可先亮成果再讲过程,或者用素材里的具体现场切入;短分享不必撑满卡片,不能添加空字段。

  • 一句主线:决定哪些机制值得展开,关键节点回扣同一个核心概念。
  • 背景与机制:先摆现象与痛点,再解释为什么是这样,让读者能沿着问题追问。
  • 最容易想错处:单独说明误区与工程依据,不埋在长段里。
  • 诚实边界:亮出经验值、半自动或尚未完成的部分,紧接着说已经留下什么。
  • 可带走的收获:用平实启示收口,让听众知道哪些动作能借鉴、哪些还要自己验。

幽默只在服务理解或拉近距离时少量使用,严肃事故复盘、正式对外和法律安全场合归零。配图帮助看清关系;缺出图能力也能用文字讲透,不能因此停止写作。

三种形态

形态读者怎样用呈现重点
文章会后回看、查出处和反例补足机制与细节,靠小标题衔接
talk现场跟着口播理解保留时间块、过渡与主线回扣,数字后说明意义
slides看当前论点,再听讲解每页一个论点与一个支撑,细节进 speaker notes;文件制作另交演示文稿技能

互转改的是呈现密度,事实、术语、数值与边界不能缩水。文章不能直接切页,幻灯片也不能逐字念出来。

幂等重试示例

沿用原文虚构题:给新入职后端同学做十五分钟内部 talk,讲接口幂等重试,不对应真实项目。主线要区分重试与重复请求的安全处理。

  1. 确定听众与重点:从重复提交和重试风暴的坑引入,让听众知道为何不能只加重试。
  2. 核实机制:重试让失败请求再试,退避与 Jitter 缓解集中重试;重复提交是否安全,还要看幂等键及服务端处理。
  3. 安排理解顺序:把「做了重试,不等于副作用不会重复」单独讲清,再说明哪部分还没走完、留下什么。
  4. 形成产物:按时间块留口播要点和可借鉴动作,不把构造例写成一次真实工程成绩。

检查与边界

人工分别看开头、技术准确、叙事弧、节奏密度和可转述收口,每项判断要有稿中证据。脚本只处理寒暄导语、未完成标记、围栏闭合、中文半角标点等字面项;字数、字段与幽默分寸还要人判。

最后换到陌生读者的视角,列出五至十个会追问的问题,逐个对稿回答,再显式过好好说话。研究与内容在前,文档平台只搬运定稿。

原图的琥珀基准调整和灰色路由均保留旧记录,当前文体以前文分工为准,历史配对成绩不作为当前技能效果证明。

100%