跳到主內容

Theme / 0.9.5

Herdr

AI 一人公司的終端辦公室

工作流組合

工作流一:建知識庫

用一段提示詞讓 agent 先訪談你,再按六個問題建出公司知識庫:九個根目錄、每目錄一份說明、最外層總規矩、四個崗位手冊,最後 git 存版本。這一步還用不到 Herdr。

適用情境

從零開公司的第一步。在普通終端裡啟動任一家 agent(不用進任何資料夾),把下面整段粘進去。

核心步驟

  1. 訪談(六個問題,一個一個答)
  2. 建骨架(一條 mkdir -p 建九個根目錄 + 訪談回答寫進主理人/品牌)
  3. 寫說明檔(九個根目錄各一份 AGENTS.md + 最外層總規矩 + 各處掛連結)
  4. 建四個崗位手冊、git 存版本

完整提示詞

我想在這台電腦上搭一家 AI 一人公司,用一個資料夾當公司的知識庫,現在先把知識庫建起來。

【規矩】
1. 先按下面「第一件」訪談我:問題一個一個問,我答完一個再問下一個。問完用幾句話複述你的理解和建庫計劃(建在哪、建哪些檔案、跑哪些命令),我說「可以」再動手。
2. 只在公司資料夾裡新建和修改檔案,資料夾以外的東西一律不動。
3. 遇到要輸密碼、要授權,或者系統彈窗,停下來告訴我該點什麼,等我說「好了」再繼續。
4. 各家 agent 怎麼讀說明檔,以它們的官方文件為準,不要憑記憶編。
5. 說明檔別寫太長,寫完量一下位元組數:最外層的公司總規矩不超過 9000 位元組(下一段還要往裡加協作規矩),每個根目錄的說明檔不超過 3000 位元組,每份崗位手冊不超過 4000 位元組。全部用中文。
命令寫法:先確認這台電腦是 macOS、Linux 還是 Windows。下面的命令按 macOS / Linux 寫,標了「Windows:」的是 PowerShell 寫法。Windows 上一律在 PowerShell 裡執行,不用 Bash 的寫法(大括號展開、mkdir -p、用 && 連接命令、用 > 寫檔案);寫檔案用你自己的寫檔案工具,存成不帶 BOM 的 UTF-8。下面說「在公司根目錄執行」,就是先進到公司根目錄再執行。

【要做的四件事】
第一件:訪談。下面這些問題,一個一個問我:
  1)你是誰:老闆怎麼稱呼、做什麼、喜歡怎麼說話、有什麼忌諱。
  2)公司叫什麼(Herdr 裡的工作區就用這個名字);公司資料夾叫什麼、放在哪。資料夾名建議用英文或拼音,例如 mycompany,命令裡更不容易出錯;預設放在使用者主目錄下。
  3)公司是做什麼的、目標是什麼、主要做哪幾項業務。
  4)產品或內容給誰看、說話是什麼口吻;視覺風格有就說,沒有就留空。
  5)電腦上能用哪幾家 agent:Claude Code、Codex、OpenCode、反重力(Antigravity CLI),或者別的。逐個執行 claude --version、codex --version、opencode --version、agy --version 幫我確認裝沒裝。
  6)每個崗位用哪家。我沒想法就按這個建議,讓每家干自己最擅長的:寫中文、查資料多的(內容經理、臨時幫手)用反重力;做影片、動效的(影片經理)用 Claude Code;增長經理換一家和內容經理不同的(審稿換一家模型,更容易看出前一家看不出來的毛病);總經理用我最順手的那家。我沒有的那家,就用我有的頂上;只有一家就全用它。
  問完,複述你的理解和建庫計劃,等我說「可以」。下面把公司資料夾的完整路徑叫作「公司根目錄」。

第二件:建骨架。
  先建公司根目錄並進去。然後在公司根目錄執行:
  mkdir -p 主理人 品牌 商業 業務 工具/技能 工具/最佳實踐 研究 角色 駕駛艙/任務 收件匣 .claude/skills .agents/skills
  Windows:New-Item -ItemType Directory -Force -Path 主理人,品牌,商業,業務,工具\技能,工具\最佳實踐,研究,角色,駕駛艙\任務,收件匣,.claude\skills,.agents\skills | Out-Null
  .claude/skills 和 .agents/skills 是給各家 agent 掛 Skill 連結用的,怎麼掛寫在第三件 工具/ 的說明裡。
  再把訪談的回答寫進去:你是誰寫進 主理人/基本信息.md;公司叫什麼、做什麼、目標、主要業務、給誰看、口吻、視覺寫進 品牌/品牌基礎.md。我沒答的項留空,不要替我編。
  成功:執行 find . -maxdepth 2 -type d -not -path './.git*' | sort,上面這些資料夾都在。Windows:Get-ChildItem -Directory -Recurse -Depth 1 -Force | ForEach-Object FullName

第三件:寫說明檔。每個根目錄放一份這個目錄自己的說明,最外層放公司總規矩。
  A. 九個根目錄各寫一份 <目錄>/AGENTS.md,每份寫四樣:這個目錄放什麼、不放什麼(不放的該去哪個目錄)、裡面怎麼分、檔案怎麼起名。按下面的要點寫,結合訪談裡我的業務:
    主理人/:放老闆自己:背景、偏好、判斷事情的方式、說話的風格。不放公司對外的口徑(去 品牌/),不放密碼。起步是 基本信息.md,以後一個主題一個檔案。
    品牌/:放公司對外的樣子:定位、講給誰聽、用什麼風格;寫文案、做封面都照這裡的調性。不放具體的成品(去 業務/)。起步是 品牌基礎.md,以後一個主題一個檔案。
    商業/:放生意怎麼賺錢、在看哪些新機會。不放正在執行的業務(去 業務/)。一個主題一個檔案。
    業務/:放正在做的每一項業務,每項一個資料夾(按訪談裡的主要業務建好,資料夾名用英文或拼音短名),做好的成品都歸到對應的資料夾裡。不放草稿和中間產物(去 駕駛艙/任務/)。成品檔名以八位日期開頭。
    工具/:放用到的工具和帳號說明(不寫密碼和密鑰);用好一個工具的過程、設定方法和踩過的坑放 工具/最佳實踐/;所有 Skill 放 工具/技能/。不放查來的原始資料(去 研究/)。一個工具或一個主題一個檔案。這一份裡還要寫一節「Skill 放哪」,內容照下面四條:
      1. 實體只有一份:工具/技能/<名字>/SKILL.md。<名字> 用小寫英文、數字和單個連字符;SKILL.md 開頭寫 frontmatter,至少兩項:name(和資料夾名一樣)、description(什麼時候用)。
      2. 在公司根目錄給它掛兩個軟連結,都指向這份實體:.claude/skills/<名字>(Claude Code 讀,OpenCode 也讀)和 .agents/skills/<名字>(Codex、反重力、OpenCode 讀)。命令:ln -s ../../工具/技能/<名字> .claude/skills/<名字>,另一個同理。用相對路徑,整個知識庫搬到哪,連結照樣有效。
      3. Windows:先試 New-Item -ItemType SymbolicLink -Path .claude\skills\<名字> -Target ..\..\工具\技能\<名字>(要開「開發人員模式」)。建不了就用目錄聯接 (Junction):New-Item -ItemType Junction -Path .claude\skills\<名字> -Target <公司根目錄>\工具\技能\<名字>;聯接記的是完整路徑,知識庫搬家後要重建;用聯接時把 .claude/skills/ 和 .agents/skills/ 兩行寫進 .gitignore,免得 git 把同一份存兩遍。聯接也建不了,才複製一份過去,並在 工具/技能/<名字>/ 裡記一句「改完要重新複製到兩處」。
      4. 改 Skill 只改 工具/技能/ 裡的實體,掛連結的兩處不用動。
    研究/:放查回來的資料和學到的東西,每份標出處和日期。不放已經定下來的做法(定下來的寫進 工具/)。檔名寫成 <八位日期>-<主題>.md。
    角色/:放員工的手冊,每個固定崗位一個資料夾,資料夾名就是崗位的英文名,裡面是 AGENTS.md 手冊和 工作記錄/。不放任務卡(去 駕駛艙/任務/)。這一份裡還要寫一節「新建崗位的做法」(老闆說「新建一個崗位」時,總經理照做),內容照下面六條:
      1. 定英文名:小寫英文字母開頭,只用小寫英文、數字和連字符,不超過 32 個字元,不和名冊裡已有的重名。資料夾、頁面、Herdr 員工名都用它。
      2. 建 角色/<英文名>/ 和 角色/<英文名>/工作記錄/。
      3. 寫 角色/<英文名>/AGENTS.md:第一行、五件事、最後一句,格式和其他崗位一樣。
      4. 在同一個資料夾裡建 CLAUDE.md、GEMINI.md 兩個指向 AGENTS.md 的軟連結(Windows 建不了軟連結時的備用寫法:兩個普通檔案,裡面只寫一行 @AGENTS.md)。
      5. 公司總規矩的員工名冊加一行;總經理手冊的分工裡加一句這個崗位管什麼。
      6. 問老闆要不要現在上崗;要,就按總規矩協作規矩第 4 條請它上崗、發報到任務卡。
    駕駛艙/:放任務卡和進度;任務卡和草稿放 駕駛艙/任務/,任務卡檔名寫成 <八位日期>-<三位編號>-<英文短名>.md,草稿以對應任務卡的檔名開頭。不放成品(去 業務/)。
    收件匣/:放過期了、暫時用不上又捨不得刪的東西;移進來時檔名前加移入那天的八位日期。不放還在用的東西。
  B. 在公司根目錄寫公司總規矩 AGENTS.md,把各目錄串起來,按順序寫這幾節:
    ■ 開頭:公司名;公司根目錄的完整路徑;Herdr 工作區名(=公司名);開工先讀什麼:「所有員工開工先讀這份總規矩,再讀自己所在資料夾的 AGENTS.md;要往哪個目錄放東西、改東西,先讀那個目錄的 AGENTS.md。」
    ■ 老闆和公司:各兩三句摘要,寫明詳細內容在 主理人/ 和 品牌/。
    ■ 知識庫怎麼分:這套分法參考了 PARA 等知識管理方法,只按幾個最簡單的問題分,求的是簡單清晰、憑直覺就知道東西放哪。每個維度一行:
      我是誰:主理人/、品牌/;我做什麼:商業/、業務/;我怎麼做:工具/(Skill 在 工具/技能/)、研究/;誰來做:角色/;遵守什麼規矩:這份總規矩;做到哪了:駕駛艙/;另外,過期的東西放 收件匣/。每個目錄放什麼,以那個目錄的 AGENTS.md 為準。
    ■ 員工名冊:四個固定崗位,每個崗位一位員工,每個一行,寫「中文名|英文名(資料夾、頁面、Herdr 員工名都用它)|用哪家」:
      總經理|gm|…  內容經理|content|…  增長經理|growth|…  影片經理|video|…
      再加一行「臨時幫手|tmp-<短名>|…」。
      用哪家寫成 Herdr 認的代號:Claude Code 寫 claude,Codex 寫 codex,OpenCode 寫 opencode,反重力寫 agy。
    ■ 臨時幫手怎麼請:誰需要誰就請(總經理或任何一位經理都可以);名字用 tmp-短名,只用小寫英文、數字和連字符,例如 tmp-guide;在公司根目錄上崗,只讀這份總規矩,不讀任何崗位手冊;做完一件事,把結果寫到任務卡指定的位置,然後關掉那一頁;誰請來的誰送走;用名冊裡臨時幫手那一行定的那家。
    ■ 底線:
      - 全部用中文;寫進檔案和交接時的路徑一律用完整路徑。
      - 草稿和中間產物放 駕駛艙/任務/;查來的資料放 研究/;自己的記錄放 角色/<英文名>/工作記錄/。
      - 除了上面這三處,其餘都是正式檔案。改正式檔案、對外發布、花錢之前,先停下來請示老闆。
      - 拿不準先問;不編資料,結論標出處;密碼和密鑰不寫進任何檔案。
      - 檔案命名:日期寫成 20261014 這樣的八位數,檔名裡不加空格;各目錄的起名規則見那個目錄的 AGENTS.md。
      - 做完一件有價值的事,用 git 存一次版本,只提交自己改的檔案。
      - Windows 上命令一律在 PowerShell 裡執行。
    ■ 協作規矩:先只寫這個標題,下面一句「裝好 Herdr 後補全」。
  C. 讓不同家的 agent 都讀得到這些說明:公司根目錄和九個根目錄裡,AGENTS.md 是正本;在同一個資料夾裡再建 CLAUDE.md 和 GEMINI.md 兩個捷徑(軟連結),都指向同目錄的 AGENTS.md:
    在每個這樣的資料夾裡執行: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 -Path CLAUDE.md -Target AGENTS.md; New-Item -ItemType SymbolicLink -Path GEMINI.md -Target AGENTS.md(一般要先在系統設定裡打開「開發人員模式」);檢查用 Get-Item CLAUDE.md,GEMINI.md | Select-Object Name,LinkType,Target。
    建不了軟連結時,不要複製一份內容代替:把 CLAUDE.md 和 GEMINI.md 建成普通檔案,裡面只寫一行 @AGENTS.md,並告訴我你用了哪種做法。這一行是 Claude Code 官方的引入寫法,只對 Claude Code 起作用;Codex、OpenCode、反重力本來就讀 AGENTS.md,不靠這兩個檔案。
  成功:wc -c AGENTS.md */AGENTS.md,總規矩不超過 9000,每個根目錄的說明不超過 3000。Windows:Get-ChildItem AGENTS.md,*\AGENTS.md | Select-Object FullName,Length

第四件:建崗位、存版本。
  1. 在公司根目錄執行:mkdir -p 角色/{gm,content,growth,video}/工作記錄
     Windows:New-Item -ItemType Directory -Force -Path 角色\gm\工作記錄,角色\content\工作記錄,角色\growth\工作記錄,角色\video\工作記錄 | Out-Null
  2. 寫四份崗位手冊,放在 角色/<英文名>/AGENTS.md。每份都寫五件事:我是誰、負責什麼、不做什麼、交付要達到什麼標準、拿不準的時候先問誰。
     第一行統一寫:「開工前先讀公司總規矩 <公司根目錄完整路徑>/AGENTS.md 和 角色/AGENTS.md(多數 agent 會自動讀到;上下文裡沒看到就先打開讀一遍)。」
     最後統一寫:「每做完一件事,在 工作記錄/ 裡記一筆:做了什麼、產出在哪、踩過什麼坑;下次遇到同樣的任務,先翻一翻。」
     各崗位的要點:
     - 總經理(gm):接老闆的話,定目標、寫任務卡、把工作安排給對應的經理或請臨時幫手、跟進、彙總給老闆;負責新建崗位。寫進這兩句原話:「老闆交代的事,我先定好目標、寫成任務卡,交給對應的經理去推進,最後彙總給老闆。」「我不親自寫長稿;改正式檔案、對外發布,先停下來等老闆確認。」再附一份分工:文章和文案找內容經理 content;流量、標題、發布節奏,以及內容上線前把關,找增長經理 growth;腳本、旁白、出片找影片經理 video;查資料、試新模型、幾個人分頭做一件事,就請臨時幫手;名冊裡沒有對應崗位的任務(例如配圖、做網站),先問老闆要不要新建崗位,或者先請臨時幫手。
     - 內容經理(content):管文章和文案;工具/技能/ 裡的 SEO 寫作 Skill 歸它管。寫進原話:「公司的文章和文案歸我;缺資料,我臨時請人去查,查完交給我。」自己寫的不當定稿,上線前交增長經理把關。
     - 增長經理(growth):管流量、標題和發布節奏,內容上線前替公司把關。把關時只提意見不重寫,逐條寫清哪一條、為什麼、怎麼改;不順著別人的思路說好話。
     - 影片經理(video):管腳本、旁白和出片。做法:寫的人不審自己,換人、換模型來挑;重要的稿多寫幾版,盲著挑。
     成功:wc -c 角色/*/AGENTS.md 每份不超過 4000。Windows:Get-ChildItem 角色\*\AGENTS.md | Select-Object FullName,Length
  3. 四個崗位資料夾裡也照第三件 C 建好 CLAUDE.md 和 GEMINI.md。
  4. 用 git 給整個知識庫存一個版本。在公司根目錄執行:
     find . -type d -empty -not -path './.git/*' -exec touch {}/.gitkeep \;
     git init && git add -A && git commit -m "建立公司知識庫"
     Windows:Get-ChildItem -Directory -Recurse -Force | Where-Object { -not (Get-ChildItem -LiteralPath $_.FullName -Force) } | ForEach-Object { New-Item -ItemType File -Path (Join-Path $_.FullName '.gitkeep') | Out-Null }
             然後分三條執行:git init;git add -A;git commit -m "建立公司知識庫"
     成功:git log --oneline -1 顯示「建立公司知識庫」。
     失敗先查:提示沒有 git → 停下來告訴我怎麼裝;提示沒設名字和信箱 → 問我,用 git config user.name "…" 和 git config user.email "…" 只設在這個倉庫裡,不要加 --global。

【最後給我一份彙報】
- 公司名、公司根目錄的完整路徑(下一段要用)
- 目錄樹,列到第二層
- 九個根目錄的說明檔:每份用一句話說放什麼、不放什麼
- 員工名冊(四個崗位加臨時幫手一行)
- 捷徑檢查:根目錄和任意一個崗位資料夾裡的檢查輸出,用的是軟連結還是一行 @AGENTS.md
- 總規矩、每份目錄說明、四份手冊各多少位元組
- git log --oneline -1 的輸出

【過關標誌】
目錄樹列出來了;公司根目錄和九個根目錄都有說明檔 AGENTS.md(加 CLAUDE.md、GEMINI.md);四個崗位資料夾裡都有手冊和 工作記錄/;版本記錄裡有「建立公司知識庫」這一條。

訪談怎麼答

可以像這樣回答:「公司叫某某,資料夾叫 mycompany,放在使用者目錄下;做 AI 自動化教學,寫給想用 AI 提高效率的普通人;說話像朋友聊天,少用術語;電腦上有 Claude Code 和 Codex。」同一段提示詞,不同的人跑出來,是不同的公司。

常見卡點

  • Windows 建不了軟連結 → 照備用做法,CLAUDE.md、GEMINI.md 寫成一行 @AGENTS.md
  • 提示沒有 git → macOS 彈窗裝開發者工具;Windows 去 Git 官網裝 Git for Windows;Linux 用套件管理器。裝完重開終端、重啟 agent,整段再粘一遍,做過的它會跳過
  • 只有一家 agent → 訪談時就說只有這家,名冊裡全部寫同一家,後面每一步照常走
  • 為什麼一定要 git → Codex 從專案根目錄(一般是 git 根目錄)往下讀到當前資料夾的 AGENTS.md;不初始化 git,崗位資料夾裡啟動的 Codex 讀不到公司總規矩
  • 知識庫能不能放影片 → 只放文字(改、存、版控都輕)。影片素材放大檔或雲端,知識庫裡寫一句它在哪