线性演示

有时让 coding agent 为你提供代码库的结构化演示很有用。

也许这是你需要了解的现有代码，也许是你自己写的但忘记了细节的代码，或者也许你是通过 vibe coding 完成的，需要了解它实际是如何工作的。

拥有合适 agent harness 的前沿模型可以构建详细的演示来帮助你理解代码是如何工作的。

使用 Showboat 和 Present 的示例

我最近用 Claude Code 和 Opus 4.6 在 Mac 上 vibe coded 了一个 SwiftUI 幻灯片演示应用。

我将在 2025 年 11 月到 2026 年 2 月之间的前沿模型进展演讲，我喜欢在演讲中至少包含一个噱头（STAR 时刻——Something They’ll Always Remember，他们总会记住的东西）。在这种情况下，我决定噱头是在演讲结束时揭示幻灯片机制本身就是 vibe coding 可以做什么的示例。

我将代码发布到 GitHub，然后意识到我实际上不知道它是如何工作的——我是通过提示让它存在的（这里有部分记录），而没有关注它编写的代码。

所以我启动了一个新的 Claude Code for web 实例，指向我的仓库并提示：

阅读源代码，然后规划一个线性的代码演示，
详细解释它是如何工作的

然后运行 "uvx showboat --help" 来学习 showboat -
使用 showboat 在仓库中创建 walkthrough.md 文件，
并在其中构建演示，使用 showboat note 添加注释，
使用 showboat exec 加上 sed 或 grep 或 cat 或任何你需要的工具
来包含你正在谈论的代码片段

Showboat 是我构建的帮助 coding agent 编写演示他们工作的文档的工具。你可以在这里看到 showboat --help 输出，它旨在为模型提供使用该工具所需的一切。

showboat note 命令向文档添加 Markdown。showboat exec 命令接受 shell 命令，执行它然后将命令和输出都添加到文档中。

通过告诉它使用”sed 或 grep 或 cat 或任何你需要的东西来包含你正在谈论的代码片段”，我确保 Claude Code 不会手动将代码片段复制到文档中，因为这可能会引入幻觉或错误的风险。

这非常有效。这是 Claude Code 用 Showboat 创建的文档，它详细讲解了所有六个 .swift 文件，并提供了关于代码如何工作的清晰且可操作的解释。

通过阅读这个文档，我学到了很多关于 SwiftUI 应用如何构建的知识，并吸收了一些关于 Swift 语言本身的可靠细节。

如果你担心 LLM 可能会降低你学习新技能的速度，我强烈建议采用像这样的模式。即使是一个大约 40 分钟的 vibe coded 玩具项目也可以成为探索新生态系统和学习一些有趣新技巧的机会。

---

原文: https://simonwillison.net/guides/agentic-engineering-patterns/linear-walkthroughs/