MarsDawn

Chip Huyen 的 read-only／write action 分类，核准前为什么要看它

Chip Huyen 在 2025 年 1 月发表的《Agents》，从教科书式的定义出发，一路写到一个更具体的分类：代理的动作分成“只是看世界”跟“会改变世界”两种。这个分类，正好可以用来判断你手上五分钟该花在计划里的哪几行。

这篇文章主张什么

Huyen 开门见山：

“An agent is anything that can perceive its environment and act upon that environment.”

（代理是任何能感知环境、并对环境采取行动的东西。）

从这里出发，她说明代理需要什么：一个可以行动的环境，还有一组决定它能做什么的工具——她称之为“tool inventory”。她点出一个分界：只是让代理能感知环境的动作是“read-only actions”，能让它对环境采取行动的动作是“write actions”。对于后者，她讲得很直接：

“Write actions enable a system to do more.”

（Write action 能让系统做到更多事。）

但她也直接点出第二种动作带来的风险：“the prospect of giving AI the ability to automatically alter our lives is frightening”（让 AI 有能力自动改变我们的生活，这个念头令人不安），照她的说法：“you shouldn’t allow an unreliable AI to initiate bank transfers”（不该让一个不可靠的 AI 去发起银行转账）。她对代理最难搞定的那一块也讲得很坦白：

“If you’ve ever been in any planning meeting, you know that planning is hard.”

（如果你参加过任何一场规划会议，就知道规划有多难。）

Huyen 在这篇文章里完全没有提到 MarsDawn，也没有推荐任何 Markdown 工具。《五分钟审完一份代理计划》已经引用她这篇文章里三句话：执行前不监督的代价、以为自己做完其实没做完的代理，还有第三步里她说系统遇到有风险的操作“可以在执行前要求人类明确核准”那一句。这篇不重复这些引文；还没看过那篇的话，下面有链接。

以下是我们的解读，不是 Huyen 的

Huyen 的 read-only／write action 分法，不是写给审阅用的建议，而是一种给工具分类的方式。但它是一个很好用的通用判断法，可以用来抓出《五分钟审完一份代理计划》第三步已经要你放慢脚步的那种有风险的操作：读一个文件、跑一次搜索、列一下目录，这些是 read-only，做错了顶多重跑一次；删数据、force push、合并分支、发信、扣款，这些是 write action——照她的说法，这种一旦做错就是“令人不安”的那种，而且等你读到代理的报告时，它可能已经做完了。她说连人坐在一起开会都觉得规划很难，这也提醒我们别对一份计划的精确度期待过高：计划读起来自信，不代表它是对的。

MarsDawn 帮得上、帮不上的地方

MarsDawn 没办法帮你判断计划里哪一步是 read-only、哪一步是 write——这是文字没标出来的判断，app 里的任何东西都不会替你读出语义。它里面也没有 AI 模型：不会帮你标出风险高的那一行，不会替你跑“规划到底有多难”的检查，也不会给计划打分数。它做的是让文件在你自己做判断的时候保持好读：侧边栏（“显示 ▸ 显示边栏”，⌃⌘S）的“大纲”标签页让你先看过计划的架构，再逐行读；源代码和排好的页面并排（⌘2），步骤图就不会卡在 Mermaid 源代码那个阶段；“编辑 ▸ 拷贝引用”（⌥⌘C）把你的位置拷贝成 plan.md:10，你一发现顺序不对的 write 动作，马上就能贴出去当反馈。

试试看

MarsDawn 已在 Mac App Store 上架。免费的 marsdawn 命令行工具现在就能用：

brew install redtear1115/tap/marsdawn

它不需要 app 就能把 Markdown 导出成 PDF。

命令行工具 · 买之前先看：MarsDawn 做不到的事

接下来

资料来源