Skill 说明
plannotator 是什么
Plannotator 要解决的是「你和 Agent 之间的反馈回路太粗糙」。它给你一个标注层:计划、规格、Markdown 文档、HTML 交互制品、代码 diff 和 PR 都能直接圈点批注,标注结果能一条命令回给 Agent,不用你手动转述。
它由几个部分组成:Inbox(收拢待看的内容)、Artifacts(HTML 制品标注)、Code Review(diffs 与 PR 评审),以及终端里的 Herdr Annotate。
| 组件 | 做什么 |
|---|---|
| Inbox | 集中查看 Agent 产出的待审内容 |
| Artifacts | 标注 HTML 制品、计划、规格、Markdown |
| Code Review | 评审 diff 与 PR,把意见发回 Agent |
| Herdr Annotate | 在终端里做同样的事 |
| Commands | annotate / code review / plan mode / CLI 子命令 |
它还有隐私与网络行为说明以及链接分享能力,团队协作时按需开启。
plannotator 怎么安装
主安装脚本:
curl -fsSL https://plannotator.ai/install.sh | bash
只要最小安装:
curl -fsSL https://plannotator.ai/install.sh | bash -s -- --minimal
锁版本 / 校验安装:
curl -fsSL https://plannotator.ai/install.sh | bash -s -- --version vX.Y.Z
curl -fsSL https://plannotator.ai/install.sh | bash -s -- --verify
只想用终端里的文档评审,可以单独装 TUI:
brew install plannotator/tap/plannotator-tui
plannotator 怎么使用
- 装好后从 Inbox 开始,Agent 交上来的计划和规格会出现在这里。
- 打开要审的内容直接在上面圈注、写意见,不用另开文档。
- 代码改动走 Code Review:对着 diff 逐行留意见。
- 标注完用一条命令把反馈发回给 Agent,它会带着这些意见继续改。
- 需要同事一起看就开链接分享;涉密内容先看隐私说明再决定。
- 纯终端工作流用 Herdr Annotate 或
plannotatorCLI 子命令。
plannotator 适合谁用
- 用编码 Agent 做长任务、需要经常审计划和 diff 的开发者。
- 团队协作里要留评审痕迹、把意见结构化回传给 Agent 的工程组。
- 经常让 Agent 产出 HTML 制品或规格文档、想直接在成品上批注的人。
- 习惯终端操作、不想开浏览器的用户(走 TUI)。
- 只是偶尔让 AI 改几行代码、几乎不需要评审的场景,装了是负担。
plannotator 项目地址
- GitHub 仓库:https://github.com/backnotprop/plannotator
- 项目官网:https://plannotator.ai
- 终端版(TUI):https://github.com/plannotator/plannotator-tui