Codex plan.md 怎么读？
AI coding agent 计划文档的
阅读方法

不要从第一行硬读到最后一行

AI 生成的计划文档经常很长。你从第一行一路读到最后一行，很容易读到一半就关掉。

更好的方式是先找 5 个东西：

1. 这份计划的最终目标是什么。
2. 它假设了哪些前提。
3. 它打算改哪些文件或模块。
4. 哪些步骤已经做完，哪些还没做。
5. 有没有风险、未知问题或需要你确认的地方。

如果这 5 个问题都能回答出来，你已经读懂了这份 plan 的主干。剩下的细节可以等真正执行或复查时再看。

一个 5 分钟阅读流程

1. 先读 H1 和前两段，看它到底要解决什么。
2. 扫一遍二级标题，只记住大结构。
3. 找任务清单，确认哪些是“要做的动作”。
4. 找代码块、文件路径和命令，判断它会碰到哪里。
5. 最后看风险、待确认和验收标准。

如果文件很长，可以先在文档开头补一个 5 行摘要：

## 我读完后的理解

- 目标：
- 会改：
- 还没确认：
- 我不同意：
- 下一步：

这 5 行不是为了“写得好看”，而是为了让你下次打开时不用重新读一遍长文档。

读在哪里，和按什么顺序读同样影响体验。反复回头看的 plan，放在 IDE 里又多占一个标签，而把它开在单独的浏览器窗口里，代码怎么切它都在。这种双屏分工的具体做法，写在plan.md 的轻量审阅工作流里。

用 NoteLoom 读本地 plan.md

如果这些计划文档已经在你的本地文件夹里，可以用 NoteLoom 打开和编辑 .md 文件。

NoteLoom 的使用方式是：在浏览器里打开应用，选择一个本地文件夹，然后直接阅读、编辑并保存里面的 Markdown 文件。

1. 用文件树找到项目里的 plan.md、tasks.md 或 README.md。
2. 先切到阅读视图，把文档当文章读。
3. 需要修改时切到编辑模式或源码模式。
4. 改完后让内容继续留在原来的本地 .md 文件里。

这里提到 Codex、Claude Code，只是在说用户手上可能已有的 Markdown 文档来源。NoteLoom 处理的是你选中的该文件夹里的 .md 文件，不接触工具里的对话。

修改 plan.md 时，别先大改结构

计划文档通常不只是给你看的，也可能会被下一轮 AI 工作流继续引用。

所以第一次修改时，建议只做小改动：

# Project Plan

## Goal
...

## Tasks
- [ ] ...
- [ ] ...

## Risks
...

不要随手删掉所有标题，也不要把任务清单全部改成一段散文。

1. 保留原来的标题层级。
2. 在不同意的地方加一条备注。
3. 在不确定的任务后面标注“待确认”。
4. 如果要大改，先复制一份备份文件。
5. 不要删除代码块里的命令，除非你确定它不再需要。

文件越来越多时，先按项目整理

如果 AI coding agent 生成的 .md 文件越来越多，先不要发明复杂知识库。一个简单目录就够：

project-name/
  README.md
  plan.md
  tasks.md
  notes.md

如果有多个项目，可以按项目分文件夹：

ai-plans/
  website-redesign/
    plan.md
    tasks.md
  seo-dashboard/
    plan.md
    notes.md

NoteLoom 支持挂载本地文件夹，也支持多文件夹管理、标签页和全文关键词搜索。文件多起来之后，你可以把同一项目的 Markdown 放在同一个文件夹里读。

什么时候适合用这种方法

这种读法适合：

1. 你已经有多个 plan.md、tasks.md、spec.md，但平时很少打开。
2. 你不是专业开发者，但需要看懂 AI coding agent 给你的计划。
3. 你想保留本地 Markdown 文件，而不是只在对话窗口里翻历史。
4. 你需要在阅读后补充自己的判断、确认项或下一步。
5. 你平时就在电脑上用 Chrome、Edge、Arc 这类浏览器看这些文件。

它不适合：

1. 你想让工具自动替你总结全部 plan。
2. 你想直接在 Markdown 编辑器里调用 AI 改代码。

NoteLoom 靠浏览器的 File System Access API 直接读写本地文件，在电脑上用 Chrome、Edge、Arc 这类 Chromium 系浏览器打开就能用。

常见坑

1. 把 plan.md 当成只能给程序员看的文件

.md 文件本质上是普通文本文件。它看起来像代码，是因为里面用了 Markdown 标题、列表和代码块。

你不需要先成为程序员，才能读懂一份计划文档。

2. 看到很长就直接关掉

长 plan 不要逐字读。先读目标、任务、风险和待确认项。

3. 改的时候把原结构删光

标题、列表、任务复选框、代码块都可能有后续用途。第一次修改时，优先加备注和补充，不要一上来重写整篇。

4. 以为 NoteLoom 会自动理解 AI 上下文

NoteLoom 管到文件为止：打开、阅读、编辑、保存本地 Markdown。对话在你和 Codex、Claude Code 那些 agent 之间。