跳到主內容
TechSpecs搜尋

Theme / 0.9.5

Herdr

AI 一人公司的終端辦公室

主題首頁GitHub ↗
工作流組合

開辦上崗與新增崗位 (Open Office)

五段提示詞的第三、四段：進 Herdr 把工作區改成公司名、照員工名冊逐崗開頁上崗、發報到任務卡；之後用一句話讓總經理照 SOP 新增崗位。

適用情境

Herdr 已裝好、權限與協作規矩已就位（見安裝 Herdr 與權限配置）。現在老闆親自在公司根目錄輸入 herdr 進入辦公室，在第一頁啟動一個 agent（通常就是總經理 gm），把這段交給它——由它照名冊把每個固定崗位請上崗。之後公司要加人，只需一句話，總經理照 角色/AGENTS.md 裡的「新建崗位做法」六步走完。

開辦：三件事

  1. 認清工作區：從環境變數拿到所在工作區編號，把名字改成公司名（已有同名就用它；另有舊的就報告）。
  2. 逐崗開頁上崗：名冊上每位固定崗位在自己的 角色/<英文名>/ 裡開一頁、用名冊代號啟動；已上線的跳過；AGENTS.md 不存在的跳過並報告。
  3. 發報到任務卡：新上崗的每位收一張卡——讀總規矩與自己手冊，在自己的 工作記錄/報到.md 寫三句話：我是誰、負責什麼、拿不準找誰。

唯一預先授權代點的確認：第一次上崗時的「是否信任這個資料夾」。

完整提示詞（第三段：開辦上崗）

在 Herdr 第一頁（開辦頁）交給 agent。＿＿＿＿ 換成你的公司名與公司根目錄：

先把辦公室布置好：照知識庫裡的員工名冊，請名冊上的每個固定崗位上崗。公司名是：＿＿＿＿，公司根目錄是：＿＿＿＿（換成你的）。員工名冊、各家啟動參數和協作規矩都寫在公司總規矩裡，Herdr 已經裝好。我剛才在公司根目錄輸入 herdr 進了 Herdr，在第一頁啟動了你，所以你現在就在 Herdr 裡。

【規矩】
1. 先確認你在 Herdr 裡：執行 echo "$HERDR_ENV"（Windows：echo $env:HERDR_ENV），輸出 1 才往下做。不是 1，就停下來告訴我：「我不在 Herdr 裡。請在公司根目錄輸入 herdr 進去，在裡面啟動我，再把這一段貼給我。」
2. 讀一遍總規矩裡的「員工名冊」「各家啟動參數」和「協作規矩」，再用幾句話說計畫：名冊上有哪幾位固定崗位、各用哪家，我說「可以」再動手。
3. 只用 Herdr 官方命令，命令和要看的欄位照下面和協作規矩裡寫的做；不確定就執行 herdr --help、只輸入 herdr agent 或 herdr tab 看用法，或讀 工具/技能/herdr/SKILL.md，不要猜。Windows 上命令在 PowerShell 裡執行。
4. 遇到要確認的，停下來告訴我。只有一種我先授權你替我點：員工第一次上崗時問「是否信任這個資料夾」，這是我自己的公司資料夾。做法：herdr agent read <英文名> --source visible，看清楚確實是在問信任；找到表示信任、允許在這個資料夾工作的那一項（不在當前高亮位置，就用 herdr agent send-keys <英文名> down 或 up 移過去），再執行 herdr agent send-keys <英文名> enter；然後 herdr agent wait <英文名> --until idle --until done --timeout 60000，等它變成 idle 或 done（剛點完信任，狀態可能還會停在 blocked 幾秒，等著就行，不要再按一次）。等到逾時還不是 idle 或 done，就再用 herdr agent read <英文名> --source visible 看它停在什麼上（有的確認框 Herdr 認不出來，會顯示 unknown 或 done），按下一句處理。其餘任何確認，一律停下來告訴我是哪一頁、在問什麼。
5. 你所在的這一頁是開辦用的，叫「開辦頁」：不要關它，也不要在裡面輸入 herdr（官方會攔住這種一層套一層的啟動）；不要執行 herdr server stop；不要動名字不是「<公司名>」的工作區（第一件 b 改名的那一次除外）。

【要做的三件事】
第一件：認清你所在的工作區，把名字改成公司名。
  - 你所在的工作區編號在環境變數 HERDR_WORKSPACE_ID 裡，開辦頁的編號在 HERDR_TAB_ID 裡（Windows：$env:HERDR_WORKSPACE_ID、$env:HERDR_TAB_ID）。記下這兩個。
  - 執行 herdr workspace list，在 result.workspaces 裡找 label 等於「<公司名>」的那一項：
    a. 找到了，就是你所在的這個：直接用。
    b. 沒找到：把你所在的這個改名：herdr workspace rename <HERDR_WORKSPACE_ID 的值> "<公司名>"。
    c. 找到了，但不是你所在的這個（以前布置過一次）：後面都用找到的那個，你所在的這個不改名、不關，最後告訴我。
  - 成功：再執行 herdr workspace list，label 是「<公司名>」的工作區有且只有一個，記下它的 workspace_id，下面叫「公司工作區」。

第二件：名冊上每個固定崗位開一頁、上崗。
  - 從總規矩的員工名冊裡列出所有固定崗位（臨時幫手那一行不算），記下每位的英文名和用哪家。不寫死名字：名冊上有幾位就布置幾位。
  - 名冊上有、但 角色/<英文名>/AGENTS.md 不存在的，跳過這一位，最後告訴我。
  - 開之前先按協作規矩第 2 條看這個名字在不在線：在線就跳過這一位。不在線，但 herdr tab list --workspace <公司工作區編號> 裡已經有同名的舊頁面（上次沒開成或重啟後留下的），照常開新頁、請它上崗，成功後再用 herdr tab close 關掉那個舊頁面。
  - 按協作規矩第 4 條一位一位來：--workspace <公司工作區編號>，--cwd "<公司根目錄>/角色/<英文名>"，--label <英文名>，--no-focus；--kind 和啟動參數照名冊和「各家啟動參數」。
  - 每位啟動成功後，用 herdr agent read <英文名> --source visible 看一眼：頁面裡要是在要求登入（例如顯示沒登入、讓你選登入方式），停下來告訴我是哪一頁，不要替我登入。
  - 成功：herdr tab list --workspace <公司工作區編號> 的 result.tabs 裡，名冊上每個英文名各有一頁；herdr agent list 裡這些名字都在。

第三件：給這次新上崗的每位發一張報到任務卡，並等結果（原來就在線、跳過的那幾位不用發）。
  - 按協作規矩第 1 條每位寫一張卡，目標都是：讀公司總規矩和你自己的手冊，在你自己的 工作記錄/報到.md 裡寫三句話：我是誰、負責什麼、拿不準找誰。產出位置寫那位的 <公司根目錄>/角色/<英文名>/工作記錄/報到.md。
  - 按協作規矩第 3 條「同時交給幾位」的寫法交出去，再按第 6、7 條一位一位等、驗收。
  - 成功：這次新上崗的每位，報到.md 都存在、三句話都寫了。

【最後給我一份彙報】
- 公司工作區：名字和 workspace_id；第一件走的是 a、b 還是 c
- 名冊上的固定崗位：每位的頁面名、用的哪家、這次是新上崗還是原來就在線；跳過了誰、為什麼
- 新上崗各位報到的三句話
- 你替我點過哪幾次「信任這個資料夾」，在哪一頁
- 最後提醒我：在左下點 gm 就能進總經理那一頁；開辦頁可以留著（以後名冊加人，就在這裡重跑這一段），不要了就在它的頁面標籤上點右鍵關掉

【過關標誌】
herdr agent list 裡，名冊上的每個固定崗位都在；這次新上崗的每位，報到.md 都寫好了。

新增崗位：一句話就夠

公司開張後要加人，不需要重跑開辦流程。對總經理說一句話（例如「幫我新建一個崗位：開發經理，英文代號 dev……」），它照 角色/AGENTS.md 裡「新建崗位的做法」走六步：

  1. 在 角色/<英文名>/ 建資料夾與 工作記錄/
  2. 寫營運手冊 AGENTS.md（第一行、五件事、最後一句，不超過 4000 位元組）
  3. 放軟連結 CLAUDE.md、GEMINI.md 指向 AGENTS.md（Windows 建不了就寫一行 @AGENTS.md 的普通文件）
  4. 加進編制：總規矩名冊加一行、總經理手冊分工加一句、名冊新增的 agent 種類補裝 integration 與啟動參數、git 提交
  5. 問老闆要不要現在上崗；要就照協作規矩第 4 條開頁、代點信任、發報到任務卡

完整提示詞（第四段：新增崗位示例）

交給 Herdr 裡的總經理 gm（任何固定崗位經理都能照辦）：

幫我新建一個崗位：開發經理，英文代號 dev。最近基建的任務多，要開發和維護公司自己用的小工具、腳本和自動化。在知識庫裡建好這個角色，把營運手冊寫好，再在 Herdr 裡把它加進編制；駕馭工程用反重力（代號 agy）。公司根目錄以總規矩開頭寫的為準。

【規矩】
1. 按 角色/AGENTS.md 裡「新建崗位的做法」辦。先說計畫：資料夾、手冊要點、用哪家。我說「可以」再動手。
2. 英文代號要符合 Herdr 對員工名的要求：小寫英文字母開頭，只用小寫英文、數字、底線和連字號，最長 32 個字元；不能和名冊裡已有的重名。
3. 只在公司資料夾裡新建和修改文件。改總規矩、寫新手冊都算改正式文件，彈確認時我會放行。
4. 這台電腦上沒有反重力（agy --version 列印不出版本號）的話，先告訴我，問我改用哪家，不要自己定。
5. 要不要現在上崗，先問我。

【要做的幾件事】
第一件：建資料夾：mkdir -p "<公司根目錄>/角色/dev/工作記錄"
  Windows：New-Item -ItemType Directory -Force "<公司根目錄>\角色\dev\工作記錄" | Out-Null
  成功：角色/dev/ 裡能看到 工作記錄/。
第二件：寫營運手冊 <公司根目錄>/角色/dev/AGENTS.md。第一行、五件事、最後一句，格式和其他崗位一樣。五件事的要點：
  - 我是誰：公司的開發經理，負責公司自己用的工具。
  - 負責什麼：按任務卡開發和維護小工具、腳本和自動化；做完寫清怎麼用、放在哪；用得上的經驗寫進 工具/最佳實踐/（改正式文件先請示老闆）。
  - 不做什麼：不碰帳號密碼和金鑰，不往任何文件裡寫金鑰；不裝要系統管理員權限的軟體；不對外發布；不改別的崗位的手冊。
  - 交付標準：交出去的東西自己先跑一遍，附上跑的命令和結果；說不清能不能用的，標「沒試過」。
  - 拿不準先問誰：技術方向問總經理 gm；要花錢、要裝軟體、要動公司資料夾以外的東西，先問老闆。
  成功：不超過 4000 位元組。
第三件：放軟連結：在 角色/dev/ 裡執行 ln -s AGENTS.md CLAUDE.md && ln -s AGENTS.md GEMINI.md
  成功：ls -l CLAUDE.md GEMINI.md 兩行都顯示 -> AGENTS.md。
  Windows：和第一段一樣，先試 New-Item -ItemType SymbolicLink；建不了，就建兩個普通文件，裡面只寫一行 @AGENTS.md。
第四件：加進編制。總規矩的員工名冊加一行「開發經理｜dev｜agy」；在你自己的手冊（角色/gm/AGENTS.md）的分工裡加一句「開發工具、寫腳本、做自動化找開發經理 dev」。名冊裡反重力第一次出現的話，按第二段的做法補兩樣：herdr integration install antigravity-cli（成功：herdr integration status 裡它顯示 current）；總規矩「各家啟動參數」裡反重力那一行沒有就補上（固定崗位、臨時幫手都不用啟動參數）。然後在公司根目錄執行 git add -A && git commit -m "新建崗位 dev"（Windows：分兩條執行）。
  成功：git log --oneline -1 顯示這次提交。
第五件：問我現在要不要上崗。要的話：按協作規矩第 4 條開一頁（--cwd "<公司根目錄>/角色/dev"，--label dev），用名冊裡的代號 agy 啟動；第一次上崗問「是否信任這個資料夾」時，看清楚再替我選信任；再按第 1、3、6、7 條發一張報到任務卡，在 角色/dev/工作記錄/報到.md 寫三句話：我是誰、負責什麼、拿不準找誰。

【最後給我一份彙報】
- 新建了哪些文件、改了哪些文件
- 手冊五件事各一句
- 名冊裡新加的那一行
- 上崗了沒有；上崗了就附上報到的三句話

【過關標誌】
角色/dev/ 裡有 AGENTS.md、CLAUDE.md、GEMINI.md 和 工作記錄/；名冊裡有 dev 這一行；要上崗的話，左下多出 dev 這一欄，報到.md 寫好了。

驗收重點

  • herdr agent list 裡名冊上每個固定崗位都在；新上崗每位 報到.md 三句話寫齊。
  • 開辦頁可以留著——以後名冊加人，在那裡重跑第三段即可。
  • 新增崗位後記得 git 提交（提示詞第四件已含），知識庫的每次擴編都有版本可查。

下一步

公司開張了，發第一項任務試運轉：見第一項任務實戰。臨時幫手的請法與送走，見臨時幫手 SOP。