Plannotator：给 AI 编程计划和代码加批注，把修改意见直接送回 Agent

IT
, , ,
1

让 AI 先写计划，再批准它动手，听起来很稳妥。但计划一长，反馈常常又变成一大段聊天：第二节保留，第三步别碰数据库，测试方案再补一下。人要反复引用原文，Agent 还得猜每句话对应哪里。

Plannotator 给这一步加了一个本地浏览器界面：直接选中计划中的文字做批注，再把意见送回编程 Agent。它也能审查代码 diff、Markdown 文档和 HTML 产物，适合想认真过一遍方案，又不想来回复制粘贴的人。

把意见贴在具体内容上

Plannotator 通过插件、hook 和命令接入编程 Agent。计划或待审内容在浏览器里打开后，可以逐段标注、评论，再把反馈交回 Agent 处理。相比只回复一句「这个方案不行」，批注至少能把哪里不行说清楚。

Plannotator 的文档批注界面
Plannotator 的文档批注界面1996×1252 128 KB

同一套界面还覆盖了代码审查：查看本地修改或远程 PR，在 diff 上评论、提出代码建议。项目支持 Git、Jujutsu、Perforce 等工作流，也接入 GitHub 和 GitLab。日常主要用 Git 的话，不必先研究其他集成。

它有意思的地方，是把「计划批准前」和「代码写完后」这两次人工检查放进了相近的操作方式里。批注不会替你判断方案对不对，但能减少把判断重新组织成提示词的麻烦。

怎么接进现有工具

项目支持 Claude Code、Codex、OpenCode、Gemini CLI、Pi 等多种编程 Agent，但各家的安装步骤和计划拦截能力并不完全一样。

以 Claude Code 为例，先用官方安装器安装本地程序。macOS、Linux 或 WSL 的入口是：

curl -fsSL https://plannotator.ai/install.sh | bash

这是下载并执行远程脚本的安装方式，执行前可以先打开脚本检查。完整安装还可能安装配套组件和修改 Agent 集成配置；只想装二进制的话，官方另有 --minimal 选项，但不会一并配置插件、hook 和命令。

随后在 Claude Code 中添加插件市场并安装插件：

/plugin marketplace add backnotprop/plannotator
/plugin install plannotator@plannotator

重启 Claude Code 后，可以从这些命令试起：

/plannotator-last
/plannotator-review
/plannotator-annotate report.html

分别用于批注上一条回复、审查当前代码改动、打开指定文件做批注。计划审查接入后，会在 Agent 提交计划时自动打开浏览器。其他 Agent 请按各自的安装步骤配置，不要直接照搬 Claude Code 的命令。

适合什么场景

如果经常让 Agent 先出实施计划，或者会让它写规格说明、生成 HTML 页面，这种逐段反馈比「再改一改」更具体。项目还有本地 Inbox，可以集中接收 Agent 留下的问题、文件和审查请求，再把回复送回对应会话。

不过，它本质上是审阅与反馈工具。代码仍然要跑测试，方案中的假设仍然要核实。接入本地界面也不等于整个工作流都离线：模型调用、远程 PR 和可选功能各有网络边界，使用前应检查对应设置。

项目信息