阅读 AI 智能体写的 Markdown 文件

AI 编程智能体会写大量的 Markdown。开始之前的计划,规格说明,关于它们做了哪些决定的笔记,完成时的报告,它们会读取的指令文件,例如 AGENTS.md 或 CLAUDE.md,还常常有一个它们不断补充的记忆文件。

这些全都是带有 #、** 和 | 的纯文本。你可以在代码编辑器中阅读,但长篇的计划和表格在那里很难读,也很容易错过智能体刚刚改了什么。

本页讲的是怎样阅读这些文件:把它们当作整洁的页面,并且以能让你看到哪里变了的方式来读。

智能体写些什么

文件它是什么谁来写
AGENTS.md、CLAUDE.md智能体在每次会话开始时读取的指令你,通常有智能体的帮助
计划和规格说明智能体即将构建的内容,一步一步列出智能体,在你要求一份计划时
笔记和决定它为什么这样做,它尝试了什么智能体
报告和摘要它做了什么,还剩下什么智能体,在任务结束时
记忆文件它了解到的关于你和项目的事情部分智能体,自行编写

针对具体智能体的页面:

三件有帮助的事

1. 读文件夹,而不是单个文件。 智能体会在多个文件夹中写入许多文件。请在 Markdown 阅读器中打开整个项目文件夹,这样你就能在计划、规格说明和报告之间切换。

2. 看到新增和已更改的文件。 智能体工作时,文件会出现和变化。你想知道是哪些文件,而不必逐个打开。

3. 看到文件内部改了什么。 当智能体编辑了你已经读过的计划时,你只想看到改动的部分,而不是把整份计划重读一遍。

在 Mac 上:PilcrowMD(测试版)

PilcrowMD Mac 版(测试版)是专为此而设计的免费 Markdown 阅读器。

PilcrowMD Mac 版(测试版)

在手机上:检查智能体的工作

智能体不在手机上运行,但你可以阅读它们写的内容。如果智能体的文件夹同步到 Google Drive,请在 PilcrowMD Android 版的我的文件夹中添加那个文件夹。

已用 Google Drive 和手机存储测试。其他云应用如果在 Android 的文件夹选择器中显示其文件夹,也可能可用。

常见问题

阅读这些文件一定要用 PilcrowMD 吗? 不用。它们是纯文本,任何编辑器都能打开。Markdown 阅读器会把表格、代码和标题显示成页面,这对长篇计划很有帮助。

PilcrowMD 会改动我的智能体文件吗? 除非你编辑并保存,否则不会。否则不会写入任何内容,并且在覆盖其他应用所做的更改之前,它会先询问。

它会把我的文件发送到别处吗? 不会。Mac 应用不建立互联网连接,Android 应用没有联网权限。在 Android 上,同步由你选择的云应用完成,例如 Google Drive。

Mac 上同样可用: PilcrowMD Mac 版(测试版)