如何高效使用Whiteboard6个实战Prompt模板让AI精准讲解你的代码变更【免费下载链接】whiteboardopen-source canvas for thoughtful software design项目地址: https://gitcode.com/gh_mirrors/whiteboard36/whiteboardWhiteboard 是一款开源的软件设计白板桌面应用它把 Claude Code、Codex 等 AI 编程智能体接入你的本地代码仓库让 AI 在可视化画布上用时序图、流程图和代码快照精准讲解你的每一处代码变更。对新手来说最大的难点不是安装而是怎么问。这篇文章整理 6 个可直接复制的实战 Prompt 模板帮你快速上手 AI 代码讲解。什么是WhiteboardAI 代码讲解的可视化白板一句话概括Whiteboard 让人类和 AI 智能体在同一个工作区里设计软件。它解决了一个很实际的痛点——AI 写完代码后你很难快速看懂它到底改了什么、为什么这么改。传统的纯文本 diff 又长又吵而 Whiteboard 的做法是图先于代码AI 会先画出时序图sequence、流程图flow_diagram或数据库结构视图database_lens再逐层下钻到具体代码行点图即跳转点击画布上的任何一个图节点或文字都能直接跳到对应的源码位置并自带 VS Code 级别的按键导航和 LSP 补全支持语义化 diff内置 Rust 编写的 AST 感知 diff 查看器大段新增函数会被摘要成伪代码测试和文档改动默认折叠只看你真正关心的变更决策日志AI 做过的每个自主决策都可以追溯到它自己的执行轨迹trace你设置的要求和 AI 的实际实现一目了然。3分钟上手三步接入你的 AI 智能体下载安装获取 Whiteboard 桌面版并打开应用安装时会同时装好whiteboard命令行工具连接智能体在欢迎界面选择 Claude Code、Codex、Cursor 等执行whiteboard connect agent并把生成的 Prompt 粘贴给你的智能体它会自动挂载 Whiteboard 的 MCP 服务发起讲解让 AI 审查你当前的分支结果会以可视化白板的形式直接打开。完整的接入流程可参考 onboarding.md 与 README.md。官方建议搭配智力、成本、速度平衡较好的大模型使用如 GPT-6 Sol、Claude Opus 系列讲解质量会明显更好。6个实战Prompt模板照着问就对了Whiteboard 的作者把问什么写进了系统提示词里但以下模板能帮你立刻拿到最佳效果。模板1分支整体讲解最常用请对比最新的 main 分支审查我当前的分支并在 Whiteboard 中打开讲解结果。这是 Quickstart 场景AI 会按what/why → 需求 → 设计 → 实现的固定结构从入口点开始带你走完全部变更。讲解结构的完整定义见 authoring.md。模板2新 API 设计讲解这一组提交是为实现【目标】的【某接口】。我想看到提议的 API 签名调用示例设计动机如果上下文或仓库里能找到的话讲完这些后我们再深入实现细节。适合 PR 评审前的自检——先对齐契约再看代码。模板3追踪特定提交的遥测/埋点变更请给我讲一下最近一次 PostHog 相关提交里的遥测变更我们在追踪哪些指标如何基于它搭建好的仪表盘或产品漏斗卡顿、错误、崩溃分别怎么处理使用 Whiteboard 输出。指定 commit 指定业务问题AI 的讲解会非常聚焦。模板4只讲解未提交的本地改动只审查我工作区里尚未提交的改动以 HEAD 为基线在 Whiteboard 上讲解。对应系统提示词中的base: HEAD用法——写完一半的代码想听 AI 点评时特别有用无需先提交。模板5追溯 AI 的决策历史Trace 考古这段代码为什么是这样写的是哪次智能体会话产生的请拉取对应的 trace 给我证据。这是 Whiteboard 的杀手锏agent 提交的 commit 里带有Agent-Session标记可以用whiteboard trace blame定位行级来源再用whiteboard trace show查看当时的完整决策现场。完整方法论见 trace-archaeology.md。模板6选中不满意的部分让 AI 重画看到画布上任何不满意的内容直接在剪贴板里高亮选中丢给你的智能体说这部分我看不太懂换一种方式在 Whiteboard 上重新讲解。AI 会针对选中区域重绘白板直到你完全看懂为止。这是把被动接收讲解变成主动追问的关键技巧。使用技巧与注意事项 ⚠️写白板是渐进的AI 会实时在你的画布上书写每隔几秒就能看到视觉进展中途可以随时打断追问私有数据放心用Whiteboard 运行在你的本地 checkout 上匿名遥测不包含代码、diff 和白板内容详见 privacy.md已知限制目前不能在 Whiteboard 里直接编辑文件单次审查跨多个仓库的体验有限分享出去后若继续修改需要重新分享。写在最后Whiteboard 的价值不在于再多一个 AI 聊天窗口而在于把 AI 的讲解变成可点击、可追溯、可追问的可视化文档图连到代码决策连到 trace问题连到下一次追问。把这 6 个 Prompt 模板存进你的提示词收藏夹下一次 review 分支时直接开用吧。【免费下载链接】whiteboardopen-source canvas for thoughtful software design项目地址: https://gitcode.com/gh_mirrors/whiteboard36/whiteboard创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考