tech-talk playbook / ai-literacy

像 Staff Developer-Advocate
一样做工程技术分享

给想让内部深度分享真正落地的工程师的一份实战 rundown —— 以 OpenDesign 自己的 agent-stream、sandbox、artifact 内部机制作为演练对象。

Platform DevEx Guild内部工程分享 · 45 min + Q&A

agenda.toml

今天的路线图

01Why now：内部分享是杠杆率最高的 devrel 渠道~5min

02Workflow map：留住听众的 6 拍节奏~10min

03Pilot：以 agent-stream 内部机制做试讲~12min

04Risk control：现场 demo 翻车应对手册~8min

05ROI + rollout：从一场分享到长期系列~5min

// why-now

问题：工程师不信任 slide，
只信任能跑起来的代码。

纯 slide 分享

把整套系统压缩成几行 bullet，资深工程师第三页就走神了——因为没有任何一处可以被证伪。

❌ 无从验证

营销式录屏演示

一段剪辑过的录屏只能证明功能能跑，不能证明你真的理解它为什么能跑——Q&A 一开始差距就暴露了。

😩 心智模型传递失败

Staff 级现场走查

现场展示真实代码路径——SSE 流、沙箱 iframe、artifact 落盘——让听众当场提问戳它。信任是攒出来的，不是讲出来的。

✅ 先验证，后相信

workflow map · 1 / 2

先画出分享的地图，再动手写第一页 slide。

选定一个真实跑着的系统，然后沿六拍展开：why now、架构图、现场走查、失败模式、影响数字、下一步。每一拍结束时，听众都应该能当场问出一个问题。

6 拍 45 分钟一个真实系统

rundown.md

// 工程技术分享 rundown
$ talk map --subject agent-stream

  ✓ Why now         ✓ 架构地图
  ✓ 现场走查         ✓ 失败模式
  ✓ 影响数字         ✓ 下一步
  …

// 6 拍，45 分钟，一个真实运行的系统
// 每一拍结束都留一个能当场问出口的问题

pilot · 2 / 2

把试讲对象选在你真正跑着的系统上。

这次试讲对象是 OpenDesign 自己的 claude-stream.ts SSE 循环、沙箱 iframe 预览、以及 artifact 落盘路径——不是假想场景，也不是 slideware。正式讲之前，先在 3 位同事面前演练过。

✦ 正式讲前演练 3 次

✦ 每一拍都掐秒计时

✦ 现场终端，不放录像

✦ 听众把问题留到最后

pilot · 5 个检查点

选定系统——agent-stream 的 SSE 循环，不是假想的例子
把失败也写进脚本——现场杀掉 daemon，讲清楚重连过程
每一拍都设硬性时限——45 分钟，计时器只有讲者能看到
找一个能打断你的资深工程师先过一遍
删掉一切"代码已经说明白，还要 slide 解释"的内容

talks/agent-stream-deep-dive/risk.md

每一场现场 demo，都要有一份写好的应急预案。

risk.md

## 已知失败模式
- daemon 流中重启：       12 秒内重连——讲出来，别藏着
- 沙箱 iframe 白屏：      切到 90 秒的录制备份片段
- Q&A 超时：            砍掉"延伸阅读"页，把时间留给听众

## 规则
- 现场 debug 不超过 60 秒；超时立刻切备份片段，事后解释

# 正式讲前，对着这份清单演练了 3 次
# 备份片段是静音 b-roll，不是提前写好的台词

// roi

值得这些演练时间的三个数字。

1 · 上手速度

看过沙箱走查的 23 位工程师，一周内就提交了第一个 agent-stream 补丁，此前平均要三周。

2 · 重复提问变少

"SSE 重连到底怎么工作"这类提问，录像上线后从每周约 9 次降到约 2 次。

3 · 可复用的模板

同样的 6 拍 rundown 这个季度又跑了两场——沙箱隔离、artifact 存储——每场准备不到 4 小时。

录像与 rundown：internal-wiki/agent-stream-talk · #eng-devrel

?

把一场好分享，变成持续的节奏

一个系统 · 一次演练 · 一份工程师真的会回看的录像

下一场：sandbox-isolation · Q3 wk2 owner: platform-devex guild

像 Staff Developer-Advocate一样做工程技术分享