跳到主內容

Theme / 0.9.5

Herdr

AI 一人公司的終端辦公室

基礎觀念

五狀態燈:怎麼來的、怎麼看

🟢 入門|側欄裡每位員工名字前的狀態點,是管理這家公司的儀表板。五種狀態各自的含義、偵測原理、以及日常怎麼用它工作。

五種狀態

燈 官方狀態 意思 你該做什麼
🟡 黃 working 在工作中 不用管
🩵 青 done 做完了、還沒人看 有空點進去看結果
🔴 紅 blocked 停下來等你回答或批准 最需要你的時候;紅燈會一層層冒泡到工作區那欄
🟢 綠 idle 看過了、已就緒,在等新任務 可以交接新工作
⚪ 灰 unknown Herdr 一時拿不準它的狀態 不是出錯——看產出文件就知道做沒做完

顏色是你螢幕上的樣子,換了主題可能不同;認狀態字(working/done/blocked/idle/unknown),不認顏色。

偵測原理(讀者關心的「它怎麼知道」)

  • 讀螢幕:Herdr 認得 20+ 種 agent CLI,靠各家專屬的偵測規則(detection manifest)掃視窗底部的狀態列文字來判斷。
  • 整合主動上報:裝了官方整合 (integration) 的那家(如 OpenCode)會直接把狀態報給 Herdr,更準;整合的另一個作用是 Herdr 重啟後能把員工原來的對話接回來。
  • 有些框認不出來:少數確認框 Herdr 認不出,側欄會顯示灰燈或青燈而不是紅燈——所以驗收永遠以產出文件為準,不信狀態燈。

unknown 最常見的來源

Codex 回答完常停在灰燈 (unknown)——官方說明這只是 Herdr 拿不準(例如 Codex 沒設終端標題時),不是出錯。等不到 idle 時,每輪等待超時後都先看產出文件在不在。

v0.9.5 更新:Codex 的狀態改回螢幕偵測——Herdr 不再安裝 Codex turn hooks(v0.9.5 起,官方原因:Codex session 啟動不再出現 clamping Interrupt hook timeout 警告)。已安裝整合者需重跑 herdr integration install codex 更新;Claude Code 的問題在 named session 中也會正確顯示為 blocked(紅燈)。

日常看法

狀態牆就是這家公司的儀表板,一套好用的節奏:

  • 早上:把要做的事交代給總經理 (gm)。
  • 白天偶爾:看一眼有沒有紅燈——紅燈等的是你的回答。
  • 晚上:回來把亮青燈的那幾欄點開,把報告看完。

判斷優先順序

  1. 交接前先 herdr agent list 看對方狀態:idle/done 可以交接;working 在忙(交了會排在它手上的任務後面);blocked 等老闆處理;unknown 先看一眼它的產出。
  2. 驗收時:產出文件存在且非空 +(狀態是 idle/done,或狀態停在 unknown 但最後幾行輸出裡有「完成 <產出路徑>」)= 做完。
  3. 對方已停下、產出文件卻不在:用 herdr agent read <英文名> --source recent-unwrapped --lines 40 看它最後說了什麼,原話轉告老闆,不替它做、不重發。