agent 做完的工作，最后都变成一份你要读的 Markdown。

做 agent 的人怎么说

以下引文照原文，我们的解读放在最后。

• Anthropic 的〈Building Effective Agents〉（Erik S. 与 Barry Zhang，2024 年 12 月）列出打造 agent 的三个核心原则，其中一条是“Prioritize transparency by explicitly showing the agent’s planning steps.”（优先重视透明度：明确展示 agent 的规划步骤。）这是写给开发 agent 的人的原则；站在你这边，这份透明就是你手上那份要读的计划。
• 同一篇也写到：“Agents can then pause for human feedback at checkpoints or when encountering blockers.”（Agent 可以在检查点或遇到阻碍时暂停，等待人类反馈。）注意原文用的是 can，可以，没有说必须。
• Chip Huyen 在〈Agents〉（2025 年 1 月）解释为什么规划要和执行分开：“Without oversight, an agent can run those steps for hours, wasting time and money on API calls, before you realize that it’s not going anywhere.”（没有监督的话，agent 可能执行那些步骤好几个小时，在 API 呼叫上浪费时间和金钱，你才发现它根本没有进展。）她也描述了一种失败：“The agent is convinced that it’s accomplished a task when it hasn’t.”（Agent 深信自己已完成任务，但其实并没有。）请它把 50 个人分到 30 间饭店房间，它只排了 40 人，还坚称做完了。
• Andrew Ng 在 The Batch（2024 年 4 月）谈 planning 这个设计模式：“On one hand, Planning is a very powerful capability; on the other, it leads to less predictable results.”（一方面，规划是非常强大的能力；另一方面，它会导致较难预测的结果。）他讲的是可预测性，并没有呼吁要人工审阅，而且他相信规划能力很快会进步。

以下是我们的推论，不是作者的主张：agent 把计划摊开、在检查点停下来，那在检查点读计划的通常就是你。agent 可能以为自己做完了，那它的“完成报告”也得有人读过。上面这几位作者都没有提到 MarsDawn，也没有推荐 MarsDawn 或任何 Markdown 工具。

比看起来难读

文件很长，重要的地方很少在最上面。里面有 Mermaid 图表和数学式，看原始码很难跟上。你读到一半，agent 可能还在改写同一个文件。它通常不只交一个文件，有时还分散在不同的分支或 worktree。等你找到问题，说“缓存那段怪怪的”，agent 只能用猜的；说“docs/plan.md:42 在回填跑完前就把旧表删了”，它就知道要改哪里。

MarsDawn 帮得上忙的地方

• 文件很长：侧边栏（⌃⌘S）的“大纲”标签页列出所有标题，点一下，两边窗格都会跳过去。
• 图表和数学式：Mermaid 和 KaTeX 直接画在预览里，和原始码并排（⌘2），两边一起卷动。
• 读到一半被改写：agent 改写文件时，MarsDawn 会重新加载，停在你原本读到的位置，前提是你自己没有未储存的修改。
• 好几个文件：用“文件 ▸ 打开文件夹⋯”（⇧⌘O）打开 agent 工作的文件夹，新文件大约一秒内就会出现在“文件”标签页；如果是 git 检出，清单上方会标出分支或工作树。
• 反馈要准：“编辑 ▸ 拷贝引用”（⌥⌘C）把目前位置拷贝成 docs/plan.md:42，“拷贝给 AI”（⌃⌥⌘C）会在下面附上你选取的文字，直接贴给 agent 就好。

另外两件事也和这个循环有关：agent 可以执行 marsdawn open plan.md:42，在 MarsDawn 里帮你打开文件，直接停在第 42 行，也就是它想先让你看的那一行；审完的文件可以从 app 导出 PDF，也可以用免费的 marsdawn export 指令。

MarsDawn 里没有 AI 模型。它不会帮你摘要计划、打分数，也不会告诉你哪里错了。读的人是你，它负责让又长又会变的文件保持好读，让你能准确指出是哪一行。

五分钟审完一份 agent 计划

用什么编辑器都适用。

1. 先只看标题。大纲和你要求的对得上吗？少一段，通常就是少做一件事。
2. 找出所有写着“完成”“通过”“已验证”的地方，挑一个自己查：打开那个文件、跑那个测试、数一下笔数。
3. 找出做了就回不去的步骤：删资料、数据库迁移、force push，还有任何会寄出、付款或发布的动作。这些要等你明确点头。
4. 图表要看画出来的样子，逐一对照每个箭头和文字说的是不是同一回事。
5. 列出计划会动到的文件和系统。你没要求的部分，执行前先问清楚。
6. 反馈写成“位置、问题、改法”：“plan.md:88：回填排在删表之后，第 4、5 步对调。”一行只讲一个问题。

时间只够做一步的话，就做第 2 步吧。以为自己已经做完的 agent，多半是在这一步被抓到的。完整版本、附实际例子：五分钟审完一份 agent 计划。

试试看

MarsDawn 已在 Mac App Store 上架。另外还有免费的 marsdawn 命令行工具：

brew install redtear1115/tap/marsdawn

它不需要 app 就能把 Markdown 导出成 PDF；agent 也能用 marsdawn open 在 MarsDawn 里帮你打开文件。

命令行工具 · 给 AI agent 的 marsdawn 参考 · 买之前先看：MarsDawn 做不到的事

接下来

• 为什么 AI 写的东西需要人读，短一点的版本：为什么 AI 写的东西还是需要人读过。
• 审阅时不占用 agent 的 context：节省 token 的审阅方式。
• agent 为什么要把计划摊开：Anthropic 说 agent 要透明，那摊开的东西谁来读？
• 上面那份清单一步一步来，附实际例子：五分钟审完一份 agent 计划。
• 不同类型的 agent 会交给你什么文件：四种 agent 设计模式，各自会交给你什么文件。

资料来源

• Erik S. 与 Barry Zhang，〈Building Effective Agents〉，Anthropic，2024 年 12 月 19 日：https://www.anthropic.com/engineering/building-effective-agents （引文依 2026-09-26 的线上版本；该文现已注明，文中提到的工具生态自 2024 年 12 月以来已有很多改变）
• Chip Huyen，〈Agents〉，2025 年 1 月 7 日：https://huyenchip.com/2025/01/07/agents.html
• Andrew Ng，〈Agentic Design Patterns Part 4, Planning〉，The Batch，2024 年 4 月 10 日：https://www.deeplearning.ai/the-batch/agentic-design-patterns-part-4-planning/