「Roughdraft」本地优先 Markdown 审稿工具：让 coding agent 先停下来等你批注

现在和 coding agent 协作，最容易失控的时刻通常不是“它不会写代码”，而是它太快开始写。你想先看一眼计划、圈出某段表达、要求它换一种优先级，结果聊天窗口和文档之间来回复制，批注也很难被 agent 准确读回去。Roughdraft 解决的正是这个中间环节：让 agent 写出一个普通 Markdown 文件，打开给你审稿，然后等你点完成再继续。

它是一个本地优先的 Markdown review app。页面上的定位很直白：commenting、suggesting edits、collaborating with your coding agent。实际工作流也很轻：让 agent 先写 plan、spec 或文案草稿，执行 roughdraft open /absolute/path/to/file.md，Roughdraft 会在本机打开这个文件；你可以在界面里做 inline comments、建议替换、删除或插入，最后点击 Done Reviewing，agent 再读取同一个 Markdown 文件继续执行。

批注不是被锁进另一个工具里

Roughdraft 比较讨喜的一点，是它没有把 review 数据变成私有格式。评论和建议会以 Roughdraft-flavored Markdown / CriticMarkup 的形式留在文件里，例如 anchored comment、substitution、insertion 这些标记都能被 agent 再次解析。换句话说，它更像给本地 Markdown 文件加了一层审稿界面，而不是要求你把内容搬进一个云端协作产品。

这也解释了它为什么适合 agent 工作流。一个复杂改动开始前，你可以要求 agent 先把计划写进 .context/plan.md，在 Roughdraft 里逐段批注：这里先别做、这里改成另一种表达、这个假设要补证据。等你点完成，agent 读到的仍然是磁盘上的同一个文件，批注、建议和回复都在上下文里，下一步执行会更可控。

本机运行，没有账号和云同步负担

安装方式是 npm i -g roughdraft，当前 npm latest 是 0.1.8。它会启动本地 server，可以用 roughdraft start、roughdraft status、roughdraft stop 管理，也支持 roughdraft open --json 这类更适合脚本和 agent 的模式。README 里还提到 experimental MCP server，可让 MCP 客户端读取 review index、等待 review event、回复或标记解决。

项目在 GitHub 上开源，TypeScript 为主，MIT License，当前约 168 stars。它现在看起来更像一个专注的单文件审稿工具，而不是完整文档平台；但也正因为范围窄，使用场景很清楚：当你希望 agent 在动手前先接受一次真正的人工 review，Roughdraft 可以把“等我批注完再继续”这件事变成一个稳定的本地工作流。