用途
Visual Recap（/visual-recap）用于把一次已经完成的代码改动——PR、分支、提交或 git diff——转换成一份交互式可视化回顾。它是“反向规划”：不描述即将做的改动，而是以高于逐行评审的视角，描述刚刚发生的改动。评审者可以先扫描改动的整体形状，再决定把注意力花在哪些具体代码行上。
主要能力
- 将 schema、API、文件与架构变更映射为统一的数据模型区块：data-model、api-endpoint、file-tree、diagram 等。
- 生成带变更标记的文件树，让评审者一眼看到改动足迹。
- 在“## Key changes”标题下，用单个水平标签页区块展示关键文件的拆分 diff，每个标签页配一行摘要和若干注释。
- 当 diff 改变了渲染 UI 时，必须包含线框图（wireframe），覆盖入口界面、交互界面、结果/持久状态以及权限/角色变体。
- 支持 Before/After 对比线框图、仅 After 线框图，以及多状态流程线框图。
- 支持顶部画布（top canvas）、故事板或流程视图。
使用方式
- 交付物始终是发布到 Agent-Native Plan 的托管交互式计划，通过 Plan MCP 连接器上的 create-visual-recap 创建，绝不使用聊天内联内容（Markdown 散文、ASCII 草图、表格、围栏“线框图”或“这是回顾”摘要）。
- 若看不到 plan（或旧版 agent-native-plans）工具，先通过宿主机的 tool_search 发现；若仍缺失，应停止并给出对应客户端的重连步骤，而不是临时拼凑内联回顾。
- 发布前或出现连接器/认证错误时，需阅读技能目录中的 references/connection.md。
- 本地文件隐私模式：当用户不希望写入托管 Plan 数据库时，不调用任何托管 Plan 工具（仅可做 schema-only 的 get-plan-blocks 目录查询），改用本地 recap collect-diff / scan / build-prompt --local-files 辅助工具读取 diff，编写本地 MDX 文件夹（kind: "recap"、localOnly: true），并用 plan local check、plan local serve --kind recap、plan local verify --kind recap 预览。使用前需阅读 references/local-files.md。
- 在聊天线程中调用时，默认范围是整个当前工作单元/线程，而非最近一条消息或后续修复；需区分线程内改动与线程前已存在的无关脏改动。
- 更新已有回顾时，应保持覆盖整个线程/工作单元加上新修正，除非用户明确要求更窄范围。
适用场景
- PR 或提交较大、涉及多文件，或触及 schema、API 契约、架构，评审者能从结构化区块中受益时。
- GitHub Action 可从 PR diff 自动生成回顾；智能体可按请求生成（如“recap this PR”“show me what this branch changed”）。
- 小型、单文件或显而易见的 diff 应跳过——回顾是评审开销，微小改动直接看 diff 更快。
限制与约束
- 回顾正文应精简：不添加样板式引言、免责声明、来源说明或摘要散文块；仅在能提供结构化区块未涵盖的具体信息时才添加散文块。
- 回顾必须有实质内容：除视觉/结构头条外，还需携带实现证据，包括改动路由/组件/弹窗/角色状态/空错误状态/共享抽象的清单、带变更标记的文件树、关键文件拆分 diff。
- 预算：3-8 个关键变更标签页；每个 diff/注释代码摘录建议不超过约 150 行；标题最多约 70 字符；简介 1-3 句。
- 线框图需遵循严格质量标准（全宽 chrome、固定底栏、真实产品内容、前后可比、正确的 surface 预设、使用 --wf-* token 而非十六进制、不使用 <html>/<style>/font 标签），编写前需阅读 references/wireframe.md。
- 有浏览器工具时，应在 Plan 查看器中渲染并目视检查一次，最多修复并重渲染一次；无浏览器时需在交接中说明。
- 链接必须使用 create 工具返回的绝对 URL（openLink.webUrl，或返回的 plan.mdx frontmatter 中的 visualUrl，或相对 MCP 服务器自身 origin 解析的 url/path）；托管 MCP 的 origin 为 https://plan.agent-native.com。不得把本地 plan.mdx 文件、本地镜像文件夹或相对路径作为主链接。
- 回顾只存在于创建它的 MCP 数据库中；单独运行的本地开发服务器有自己的数据库，不会包含通过托管 MCP 创建的回顾，手拼 localhost 链接会返回“Plan not found”。
- 私有仓库的 PR 回顾链接不是公开 URL，需在 PR 评论/交接中明确评审者可能需要登录有该组织访问权限的 Agent-Native Plans 账户。
- 在 Codex 中且浏览器工具可用时，创建后自动在浏览器打开返回的绝对 URL，但最终回复仍需包含同一绝对 URL。
暂未提供
关于收费、价格、平台支持范围、具体效果指标等信息，资料中暂未提供。