Plannotator:在 Agent 動手之前先審計畫,本機瀏覽器裡標註、審 diff、一鍵把回饋送回 Agent
本內容僅供參考,詳細使用規則與工具安全性與否,建議要進行相關安全性測試與評估
用 Coding Agent 最常見的後悔時刻,是 Agent 已經改了二十個檔案之後,你才發現它一開始就理解錯了需求。許多 Agent 都有「計畫模式」——先列出要做什麼,再動手——但計畫通常只是終端機裡的一大段文字,很難仔細看、更難精準地指出「第三步不對、第五步漏了測試」。Plannotator(backnotprop/plannotator)要解決的就是這件事:讓你在 Agent 動手之前,用一個真正的審查介面來看計畫、做標註、給回饋。根據 11 月 15 日的報導,它在 GitHub Trending 上 24 小時內新增約 860 顆星,目前約 12.6k stars,11 月 16 日剛釋出 v0.28.66。
1. 專案背景與定位
Plannotator 採 Apache-2.0 或 MIT 雙授權(使用者可擇一),官方描述是「讓你跟上並掌控 Agent 的工作台——塑造、決策、規劃、標註、審查程式碼、與團隊分享,並一鍵把所有回饋送給 Agent」。
README 的定位更精確:它是一個「本機、以瀏覽器為介面的 AI Coding Agent 審查面板」,支援 Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、DeepSeek Harness 與 Pi。從最初的「計畫審查」,已擴展到標註任意 Markdown 與 HTML、審查 diff 與 PR,以及讓 Agent 留言給你的 Inbox。
2. 技術架構與核心設計
- 計畫審查流程(以 Claude Code 為例):
- Agent 結束計畫模式時,觸發一個 hook
- 本機伺服器從 hook 輸入讀取計畫內容
- 瀏覽器自動開啟審查介面
- 你可以核准(Agent 繼續執行)或退回(把結構化的回饋送給 Agent)
- Agent 修改後,介面會顯示計畫前後的差異
- 程式碼審查:
/plannotator-review會執行 git diff(或透過網址抓取 PR),在瀏覽器的 diff 檢視器中逐行標註、stage/unstage 檔案,回饋直接送回 Agent 的 session;支援 Git、GitButler、Jujutsu、Perforce、GitHub 與 GitLab。「導引式審查」還能讓 Agent 先把 diff 分成幾個章節。 - 標註任何東西:計畫、規格、Markdown、HTML、資料夾、Agent 的最後一則訊息,甚至本機開發中的網站(透過本機 proxy 與熱重載)。
- 內建 AI:可以詢問 AI 正在審查的內容,或讓 AI 先在 diff 上留下審查意見(可關閉)。
- Inbox:Agent 可以在同一個本機視窗中留下訊息、問題、檔案與導引式審查。
- 分享:把計畫轉成連結給同事標註,再匯入回饋。
- 整合:VS Code 擴充、Obsidian(自動把核准的計畫存進筆記庫)、Bear、Notion。
- 非阻塞模式:在新版 Claude Code 上,審查不會讓 Agent 停下來等待,決定會稍後以訊息形式送達。
3. 社群熱度與生態採用
約 12.6k stars、1.2k forks,main 分支有將近 1 萬次 commit,版本更新極為頻繁(11 月 12 日到 16 日間就釋出了五個版本)。v0.28.66 單一版本就有 19 位貢獻者參與。供應鏈安全方面也做得相當完整:每個二進位檔附 SHA256 校驗檔,從 v0.17.2 起提供 SLSA provenance,並附上 CycloneDX SBOM;repo 也設定了 gitleaks 與 semgrep 掃描。
4. 局限性與潛在風險
- Hooks 會執行程式:Plannotator 透過 Agent 的 hooks 運作,安裝等於讓它在每次計畫或審查時被自動執行;建議從官方管道安裝,並善用
--version鎖定版本與--verify-attestation驗證來源。 - 分享連結就是鑰匙:README 說明,小型分享直接存在連結本身,大型分享會先加密再上傳、7 天後過期,但「任何擁有完整連結的人都能讀取」。敏感的計畫或程式碼不應分享,或以
PLANNOTATOR_SHARE=disabled關閉,也可以自架分享服務。 - 網址標註會經過第三方:標註網址時預設使用 Jina Reader 擷取內容,等於把網址送到第三方服務;可用
PLANNOTATOR_JINA=0關閉。 - 遠端模式沒有登入機制:遠端/SSH 模式會監聽
0.0.0.0且沒有驗證,README 提醒不要對不受信任的網路開放該 port。Inbox 本身也是單人設計、沒有登入。 - 各 Agent 支援程度不一:Droid 目前只有指令、沒有計畫攔截;Codex 的計畫審查依賴實驗性的 hook;Gemini CLI 需要較新的版本。
- 安裝會連網:完整安裝可能連到 GitHub、npm 與其他相依服務;詳細的資料邊界需參考官方隱私政策。
- 審查本身仍需投入時間:工具讓審查變容易,但如果只是習慣性按下「核准」,它也無法阻止錯誤的計畫被執行。
5. 應用價值與適用場景
最適合已經大量使用 Coding Agent、想把「人類審查」放回流程中的開發者與團隊:在 Agent 動手前審計畫,比事後審幾百行的 diff 便宜得多;團隊可以透過分享連結讓資深成員一起看計畫;把核准的計畫自動存進 Obsidian,也能逐漸累積成團隊的設計決策紀錄。對使用多種 Agent 的人來說,它還提供了一個統一的審查介面。
Monday 的觀點與架構建議
- Plannotator 抓住了一個關鍵事實:審查越早,成本越低。計畫階段的一句「這裡不對」,可能省下 Agent 半小時的錯誤實作與你一小時的 code review。
- 「結構化回饋」比自由文字更有價值:把意見精準地掛在計畫的某一步或 diff 的某一行,Agent 修正的準確度會高很多。這和 Orca 的 diff 註解是同樣的思路。
- 導入建議:鎖定版本並驗證簽章;預設關閉分享與第三方網址擷取,需要時再開;遠端模式只在受信任的網路中使用;把核准的計畫存檔,作為日後追溯「為什麼這樣做」的依據。
- 回顧這兩個月,Agent 工具從「讓 Agent 更能幹」(Skill、記憶、上網),逐漸擴展到「讓人類更能掌控 Agent」(Orca 的編排、iFixAi 的稽核、Codewhale 的收據、Plannotator 的計畫審查)。當 Agent 變得越來越自主,人類的審查介面就越重要——這可能是下一個值得投資的工具類別。
Friday