写技术教程最尴尬的一点：文字讲得头头是道，读者一跑代码全是坑。我这些年攒了不少笔记，一直想找个既能写概念、又能嵌可运行实验、还能一键出网站/PDF/EPUB 的工具。Quarto + Notebook 这套组合基本满足了我的贪心。本文用一个"AI Agent Loop 入门教程"做实例，从二十行的最小循环骨架，一路加料到接真模型、上安全文件工具、加记忆和任务验收的可用 Agent，演示怎么把 .qmd 文字章节、.ipynb 可运行实验、Mermaid 时序图拼成一本能在线读、能导出出版的书。

Go 的隐式接口（duck typing）写起来很爽，但代价是"看不见"——一个 struct 到底实现了哪些接口，光看代码根本一眼看不出来。这篇不改语言、不等官方，从编译期断言、gopls 双向跳转、golangci-lint、go generate 到自己写工具生成 UML 类图（附开源项目 gouml），一层层把可发现性补回来，附可跑的例子和一份可落地清单。