跳到主內容

Theme / 0.9.5

Herdr

AI 一人公司的終端辦公室

基礎觀念

任務卡:交接的唯一介面

🟢 入門|員工之間交接工作,話只有一句、內容全在一張卡裡。任務卡是這家公司唯一的交接介面——話短不會被截斷,卡是檔案、事後能查。

一張卡長什麼樣

任務卡放在 駕駛艙/任務/,檔名寫成 <八位日期>-<三位編號>-<英文短名>.md(編號接著資料夾裡最大的往下排):

# 任務卡 001 · <一句話標題>

交出人:<中文名>(<英文名>);接手人:<中文名>(<英文名>);臨時幫手的 tab_id:<沒有就空著>

## 目標

## 材料(完整路徑或網址)

## 規矩

## 產出位置(完整路徑)

交接就這一句,不改寫

herdr agent prompt <英文名> "讀任務卡 <任務卡完整路徑>,按卡做完,結果寫到卡里的產出位置,最後只回一句:完成 <產出完整路徑>" --wait --timeout 110000

為什麼話要這麼短:

  • 發送不截斷——交接的話只有「讀任務卡,按卡做完」,長內容全在卡裡。
  • 可審計——卡是檔案,誰交給誰、交了什麼、產出在哪,事後都能查。
  • 可重放——同一張卡可以再交給別人做,內容零損耗。

驗收:以產出文件為準

做完的定義是:產出文件存在、不是空的,並且滿足一條:

  • 對方的 agent_status 是 idle 或 done;或者
  • 對方停在 unknown,但 herdr agent read <英文名> --source recent-unwrapped --lines 40 的最後幾行裡有「完成 <產出完整路徑>」。

不信狀態燈、不信「完成」兩個字——打開產出文件讀。

三條鐵律

  1. 絕不重發同一任務。同一個任務發兩遍,員工會做兩遍、寫亂文件——這是多員工協作裡最常見的事故。等不到就一輪一輪 herdr agent wait(每輪 ≤110 秒),先看產出文件在不在。
  2. 等不到不等於失敗。退出碼 1、error.code 是 timeout 或 agent_prompt_stalled:話多半已經送到,接著等;是 agent_blocked:話沒送出去,先處理紅燈;是 agent_not_found:回頭 herdr agent list 看對方在不在。
  3. 對方停著等確認(blocked)不硬發。紅燈等的是只有老闆能回答的問題——讀它螢幕上在問什麼,轉告老闆,不替老闆按鍵。