← 返回部落格
Ai預計閱讀 8 分鐘

plannotator 在每個 agent diff 前面放了一個人工檢查點

發布於 2026年11月14日
plannotator 在每個 agent diff 前面放了一個人工檢查點

agent 輔助開發裡有一個時刻會讓事情變糟,不會變好。agent 做完任務,打一段總結,問你要不要接受。你往下滾。diff 有四百行。你點了同意,因為認真讀一遍比自己寫一遍還慢。

plannotator 這週漲到大約 10,500 星,還在快速往上走,就是衝這個時刻來的。它是一塊本機的瀏覽器審閱面板,掛在編碼 agent 上,agent 有東西要你決定的時候自己彈出來。你在計畫、文件或 diff 上做標記,意見作為 agent 的下一步輸入回去。

標語講的是「留在迴路裡」。架構講的東西更窄也更有用:把人的注意力當成一個正式步驟,別讓它變成可選項。

它怎麼掛上去

它不替代你的 agent,它插到一個 agent 上。README 列了 Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、DeepSeek Harness 和 Pi,Inbox 也能和 Grok Bot、Muse、Hermes、OpenClaw 這類個人助理一起用。接法走各家 harness 的外掛、hook 和指令,所以整合深度按工具不同。

指令是熟悉的那一套:

/plannotator-review                    # uncommitted changes
/plannotator-review <github-pr-url>    # a pull request
/plannotator-annotate README.md        # a file
/plannotator-annotate https://docs.rs  # a URL
/plannotator-last                      # the agent's last message
plannotator inbox                      # the queue

在 Codex 上,斜線指令變成 `!plannotator ...`,或者用打包好的 skills。計畫模式一句指令都不用寫:它走 harness 的 hook,agent 一寫計畫,審閱面板自己就開。這個細節比聽上去重要。要靠你記得去呼叫的檢查點,會在你最忙的那幾天被跳過,而那幾天恰好最需要它。

審閱支援 Git、GitButler、Jujutsu、Perforce、GitHub 和 GitLab,不綁在某一個 forge 上。你可以按行留言、提程式碼建議,留言回給 agent,不會跑進一個沒人看的 PR 討論。

收件匣才是有意思的部分

單 agent 審閱是個已經解決的問題,解法也無聊:打開 diff,留留言。

Inbox 是團隊為大多數人真實處境做的東西,那個處境是好幾個 agent 同時在跑。它是一個本機視窗,agent 在裡面留訊息、提問、丟檔案、發起引導式審閱,同時繼續幹活。你點一下回答問題,標註一個檔案,有空了按傳送。整個過程不佔著任何 agent 工作階段,回覆會回到提問的那個工作階段。

這一句話解掉了一個真實的死結。human-in-the-loop 的標準做法是 agent 停下來等。一個 agent 沒問題。四個 agent 的時候,你成了系統裡最慢的行程,另外三個在燒上下文等你吃完午餐。非同步收件匣讓 agent 把問題存著,工作階段不用停。

Claude Code、Pi 和 OpenCode 透過外掛連線,回覆作為下一輪到達。其他工具用 MCP 接,指令是 `plannotator inbox mcp`,而 `plannotator inbox --help` 順便就是 agent 學這套協定的文件。小設計,效果不小:說明文字就是整合規格。

為什麼用瀏覽器,為什麼在本機

終端裡的 diff 讀程式碼夠用,讀別的東西很難受。在產品規格、HTML 稿或算圖出來的報告上用分頁器審閱,基本是瞇著眼看,而 agent 現在這三樣都在穩定產出。把它們算圖進瀏覽器,讓審閱者在結果上打點,對這類產物才是對的介面。

plannotator 本機審閱面板的介面示意圖

README 的隱私一節,對這個體量的工具來說具體得少見,值得把實質攤開說。沒有遙測。計畫、diff、標註、草稿和歷史預設留在本機。每個介面載入時向 GitHub 查最新版本,這個檢查沒法關。本機 Git 審閱可能對你設定的 origin 跑 `git ls-remote`,判斷預設分支和基線是否過期,觸發時機是審閱打開時、diff 載入時、切換 base 時、按 fetch 時。閒置的審閱頁面不發任何網路請求,這個承諾比大多數工具硬。

內容只在聯網功能需要時才離開機器:URL 標註去抓那個頁面,GitHub 審閱走已驗證的 CLI,Ask AI 把選中的問題和上下文發給你設定的供應商,分享把密文上傳到 paste 服務。

對一個架在原始碼上面的工具來說,這種揭露是對的直覺。agent 工具最典型的壞法,是一個貼心的幫手把你的儲存庫傳上伺服器還不說,使用者唯一的防線是維護者在被問之前就把邊界寫清楚。

不舒服的那層含義

這個專案從頭到尾押的是一個判斷:agent 工作的瓶頸是人的審閱頻寬,模型能力已經夠用。

在我看來這個判斷是對的。我認識的那些同時跑幾個 agent 的人,一天大部分時間在閱讀:計畫、diff、測試輸出、agent 說自己幹了什麼的總結。生成這一段很快,而且越來越快。驗證這一段的上限是一個人讀和決定的速度。

還有個二階效應值得說。記錄決策的審閱面板,會順手留下決策的檔案。plannotator 有 archive 指令,可以唯讀地翻看存下來的計畫決策,標註留在資料目錄裡,終端審閱和應用審閱的產物積在同一個地方。等你手上有幾百份通過的計畫,以及塑造了它們的留言,你就擁有了任何單個工作階段都不包含的東西:一份關於你們團隊怎麼決策的描述。

那才是資產。diff 閱讀器誰都能做,真正攢下來的是推理的軌跡。

現在還不舒服的地方

兩點,都是結構性的。

第一,審閱工具改善的是審閱,審閱和正確是兩回事。給一個壞架構做一份標註漂亮的批准,仍然是對壞架構的批准,而整潔的審閱面板會讓「批准」感覺像盡職。Inbox 尤其容易讓人清空佇列,清空佇列和理解佇列是兩種行為。

第二,這個工具給一個原本只有終端的工作流,加了瀏覽器、本機服務和 hook 層。多了三個會壞的東西,而 hook 壞掉是靜默的:agent 沒經過檢查點就往下走,你過一陣才發現。

這兩筆代價,為了買到的東西都算划算,那個東西是一個讓人站進去的位置。另一種做法是大多數團隊在做的:讀一遍聊天記錄,指望重要的部分剛好在裡面。

如果你想試一件事

下一次有未提交的改動,跑一遍 `/plannotator-review`,在三行上留留言,哪怕沒什麼可說的。留言本身不重要。你要知道的是,當介面是為審閱設計的,一次真正的審閱要花多久,這個數字就是你新的吞吐上限。大多數團隊從來沒量過。

相關文章