有时，让一个编码助手为你提供代码库的结构化 walkthrough 非常有用。
也许你需要快速掌握现有的代码，也许是你自己写的代码，只是已经忘了细节；又或者，你完全凭感觉写下了整段代码，现在需要弄清楚它到底是怎么运作的。
配备合适代理的前沿模型能够构建详细的操作指南，帮助你理解代码的工作原理。
一个使用Showboat和Present的示例
我最近用Claude Code和Opus 4.6在我的Mac上用SwiftUI编写了一款幻灯片演示应用。
我正在讲述2025年11月至2026年2月期间前沿模型的进展，而且我喜欢在演讲中至少加入一个噱头（一个……）明星时刻——他们将永远铭记的事）。在这种情况下，我决定在演示文稿的最后揭晓一个噱头：幻灯片的机械装置本身正是振动编码能够实现的一种范例。
我发布了代码到 GitHub然后我意识到，自己根本不知道它到底是怎么运作的——我竟然是凭空催生了这一切！部分文字在此完全不理会它所编写的代码。
于是，我启动了一个新的Claude Code for web实例，将其指向我的仓库，并输入了以下提示：
阅读源代码，然后规划一段线性代码 walkthrough，详细解释其工作原理。
然后运行“uvx showboat –help”以了解showboat的用法——使用showboat在仓库中创建一个walkthrough.md文件，并在其中构建操作指南。利用showboat note添加注释，同时借助showboat exec以及sed、grep、cat或其他你需要的工具，插入你所提及的代码片段。
游船是我开发的一款工具，旨在帮助编码代理撰写展示其工作的文档。你可以看到该表演船——帮助输出在此，旨在为模型提供使用该工具所需的一切信息。
那个炫耀性笔记命令会将Markdown添加到文档中。该表演型高管该命令接受一个 shell 命令，执行该命令，然后将该命令及其输出都添加到文档中。
通过指示它使用“sed、grep、cat 或任何你需要的工具来包含你所讨论的代码片段”，我确保了Claude Code不会手动将代码片段复制到文档中，因为那样可能会带来幻觉或错误的风险。
这效果非常好。以下是：使用Showboat创建的克劳德代码文档，其中涵盖了全部六个斯威夫特详细地介绍文件，并对代码的工作原理提供了清晰且可操作的解释。
仅通过阅读这份文档，我就对SwiftUI应用程序的结构有了很多了解，还深入掌握了一些关于Swift语言本身的扎实细节。
如果你担心大型语言模型可能会降低你学习新技能的速度，我强烈建议你采用类似这样的模式。即使只是一个大约40分钟就能完成的趣味编码小项目，也能成为探索全新生态、掌握一些有趣新技巧的绝佳机会。