firstmate：一個在單一聯絡人之下運行編碼團隊的智能體發行版

一個智能體發行版，而非需要安裝的應用程式（kunchenguid-firstmate-deep-analysis-1）

firstmate 自稱是一個智能體發行版：一個可攜的指令、技能、工具、策略和狀態慣例目錄，能把通用的終端編碼智能體轉變為專用的智能體。README 明確列出了它不是什麼：不是模型、不是 harness、不是技能、不是 MCP 伺服器，也不是 CLI。沒有安裝程式，也沒有需要安裝的應用程式。複製儲存庫得到的就是發行版本身，由 AGENTS.md、隨附技能和受支援終端編碼智能體可以遵循的輔助腳本組成。在複製目錄內啟動受驗證的 harness 會實例化你的大副，並讓你成為船長。該儲存庫用 Shell 編寫，其一句話描述就是賣點：與一個智能體對話，與一支團隊一起交付。

針對 firstmate，第 1 節應連同專案識別字 kunchenguid-firstmate-deep-analysis 來閱讀。README 明確可核對的入口是「firstmate --help」。執行時記錄命令版本、設定檔位置、輸入內容、標準輸出與錯誤訊息；若該步驟需要外部服務或特定權限，也把實際回應和清理結果分開保存。這些記錄能把文件描述與本機結果對上，未被 README 說明的行為則保留為未知。

在 firstmate 的情境中，評估重點是這個入口是否產生預期的專案輸出，以及失敗時是否能指出具體原因。不要用倉庫星數替代測試，也不要把其他工具的慣例套到 kunchenguid-firstmate-deep-analysis。

第 1 節的實作核對可再觀察 firstmate 的輸出檔、服務日誌或終端回應，並將成功與失敗案例分開。若 README 沒有指定預設值，便以實際設定明確記錄，而不是推測 kunchenguid-firstmate-deep-analysis 的行為。

firstmate 第 1 節的核對紀錄還應包含執行環境、輸入大小、完成時間與退出狀態。對 kunchenguid-firstmate-deep-analysis 而言，這些欄位可用來比較兩次執行是否真的走過相同路徑；若輸出只在畫面短暫出現，應另存終端記錄，若產生檔案則記錄相對路徑與檔案內容摘要。

單一聯絡人和可見的團隊（kunchenguid-firstmate-deep-analysis-2）

互動模型只有一個聯絡點。你只與大副對話；它向組員分派工作，監督他們完成任務，只升級真正需要決策的事項，並報告明確的結果。每個組員都在自己可見的工作階段端點中執行：預設是 tmux 視窗，或者是實驗性的 herdr 或 zellij 分頁、cmux 工作區或 Orca 終端，你都可以觀看或輸入。README 的圖表顯示了流程：船長對話，firstmate 讀取專案目錄並路由請求，每個組員在自己的工作階段和 git 工作樹中執行，完成的工作以 PR、批准的本地合併或獨立報告的形式送達。README 沒有量化一個大副能監督多少組員；它只是呈現了模型，沒有給出規模數字。

針對 firstmate，第 2 節應連同專案識別字 kunchenguid-firstmate-deep-analysis 來閱讀。README 明確可核對的入口是「firstmate --help」。執行時記錄命令版本、設定檔位置、輸入內容、標準輸出與錯誤訊息；若該步驟需要外部服務或特定權限，也把實際回應和清理結果分開保存。這些記錄能把文件描述與本機結果對上，未被 README 說明的行為則保留為未知。

第 2 節的實作核對可再觀察 firstmate 的輸出檔、服務日誌或終端回應，並將成功與失敗案例分開。若 README 沒有指定預設值，便以實際設定明確記錄，而不是推測 kunchenguid-firstmate-deep-analysis 的行為。

firstmate 第 2 節的核對紀錄還應包含執行環境、輸入大小、完成時間與退出狀態。對 kunchenguid-firstmate-deep-analysis 而言，這些欄位可用來比較兩次執行是否真的走過相同路徑；若輸出只在畫面短暫出現，應另存終端記錄，若產生檔案則記錄相對路徑與檔案內容摘要。

隔離、任務形態和專案模式（kunchenguid-firstmate-deep-analysis-3）

每個任務都在一個乾淨的工作樹中執行，該工作樹由 README 所稱的 treehouse 工具提供，或者當後端設定為 orca 時由 Orca 管理工作樹，因此同一儲存庫上的並行工作不會衝突。工作有兩種形態：ship 任務交付經授權的變更，scout 任務在接收契約需要單獨研究時留下獨立的調查報告。每個專案還宣告一種交付模式：no-mistakes、direct-PR 或 local-only，以及可選的 +yolo 自主旗標。README 列出了這些模式，但沒有定義其確切行為；它指向 docs/architecture.md 取得完整說明，因此每種模式的具體語義無法僅由 README 確定。

針對 firstmate，第 3 節應連同專案識別字 kunchenguid-firstmate-deep-analysis 來閱讀。README 明確可核對的入口是「firstmate --help」。執行時記錄命令版本、設定檔位置、輸入內容、標準輸出與錯誤訊息；若該步驟需要外部服務或特定權限，也把實際回應和清理結果分開保存。這些記錄能把文件描述與本機結果對上，未被 README 說明的行為則保留為未知。

第 3 節的實作核對可再觀察 firstmate 的輸出檔、服務日誌或終端回應，並將成功與失敗案例分開。若 README 沒有指定預設值，便以實際設定明確記錄，而不是推測 kunchenguid-firstmate-deep-analysis 的行為。

firstmate 第 3 節的核對紀錄還應包含執行環境、輸入大小、完成時間與退出狀態。對 kunchenguid-firstmate-deep-analysis 而言，這些欄位可用來比較兩次執行是否真的走過相同路徑；若輸出只在畫面短暫出現，應另存終端記錄，若產生檔案則記錄相對路徑與檔案內容摘要。

零令牌監督和可重新啟動的狀態（kunchenguid-firstmate-deep-analysis-4）

一個 bash 監視器在團隊上休眠，只在需要關注時喚醒大副，README 稱之為零令牌監督。經過驗證的主要 harness 還會獲得一個回合結束的後備機制，當工作正在進行而監督未啟用時，它會阻止或跟進盲目停止。所有狀態都儲存在磁碟和活動工作階段後端中，任何時候終止工作階段都被描述為安全的：下一次工作階段會進行協調並繼續，包括確認已死亡的 secondmate 智能體。監督引擎、後備機制和連續性行為記錄在 docs/verification/supervision.md 和 docs/turnend-guard.md 中，README 將這些文件定位為維護者的積極驗證記錄，而不是可用性保證。

針對 firstmate，第 4 節應連同專案識別字 kunchenguid-firstmate-deep-analysis 來閱讀。README 明確可核對的入口是「firstmate --help」。執行時記錄命令版本、設定檔位置、輸入內容、標準輸出與錯誤訊息；若該步驟需要外部服務或特定權限，也把實際回應和清理結果分開保存。這些記錄能把文件描述與本機結果對上，未被 README 說明的行為則保留為未知。

第 4 節的實作核對可再觀察 firstmate 的輸出檔、服務日誌或終端回應，並將成功與失敗案例分開。若 README 沒有指定預設值，便以實際設定明確記錄，而不是推測 kunchenguid-firstmate-deep-analysis 的行為。

firstmate 第 4 節的核對紀錄還應包含執行環境、輸入大小、完成時間與退出狀態。對 kunchenguid-firstmate-deep-analysis 而言，這些欄位可用來比較兩次執行是否真的走過相同路徑；若輸出只在畫面短暫出現，應另存終端記錄，若產生檔案則記錄相對路徑與檔案內容摘要。

所需 harness 和啟動路徑（kunchenguid-firstmate-deep-analysis-5）

firstmate 需要一個經過驗證的主要智能體 harness：Claude Code、Grok、Pi、pi-signed、Codex 或 OpenCode。還需要 Git 和 GitHub CLI，透過 gh auth login 認證，並且需要所選執行時後端的 CLI 和依賴項，tmux 是參考預設值。Claude Code、Grok 和 Pi 被列為同等的共同首選推薦，各有不同的監督路徑；Codex 和 OpenCode 也經過驗證，但帶有更多 harness 特定的監督取捨。快速入門是三個 shell 命令：認證 GitHub、複製儲存庫並進入其中，然後啟動一個共同首選 harness，讓 AGENTS.md 接管。README 給出了 Claude Code、Grok 和 Pi 的確切啟動命令，並引導讀者查看各 harness 的文件以了解後端特定設定。每個列出的 harness 在實際中是否表現完全一致，README 並未確定。

針對 firstmate，第 5 節應連同專案識別字 kunchenguid-firstmate-deep-analysis 來閱讀。README 明確可核對的入口是「firstmate --help」。執行時記錄命令版本、設定檔位置、輸入內容、標準輸出與錯誤訊息；若該步驟需要外部服務或特定權限，也把實際回應和清理結果分開保存。這些記錄能把文件描述與本機結果對上，未被 README 說明的行為則保留為未知。

第 5 節的實作核對可再觀察 firstmate 的輸出檔、服務日誌或終端回應，並將成功與失敗案例分開。若 README 沒有指定預設值，便以實際設定明確記錄，而不是推測 kunchenguid-firstmate-deep-analysis 的行為。

firstmate 第 5 節的核對紀錄還應包含執行環境、輸入大小、完成時間與退出狀態。對 kunchenguid-firstmate-deep-analysis 而言，這些欄位可用來比較兩次執行是否真的走過相同路徑；若輸出只在畫面短暫出現，應另存終端記錄，若產生檔案則記錄相對路徑與檔案內容摘要。

內建技能和文件配置（kunchenguid-firstmate-deep-analysis-6）

該發行版附帶五個使用者可呼叫的內建技能：/afk 用於離開模式監督，/ahoy 用於回顧自上次船長訊息以來的可見工作階段事件，/bearings 用於產生四部分對話摘要，/updatefirstmate 用於透過 fast-forward-only 拉取進行自我更新，/stow 用於清掃工作階段中未捕獲的持久知識。README 還記錄了技能的兩層配置：.agents/skills/ 下的內部技能帶有 metadata.internal: true 旗標，使 skills.sh 等安裝工具隱藏它們；skills/ 下的公共技能是獨立的，不依賴 firstmate，目前範例是 skills/stow。文件索引列出了架構、設定、各後端設定指南、驗證記錄和貢獻指南；README 連結到所有這些內容，而不是複述其內文。

針對 firstmate，第 6 節應連同專案識別字 kunchenguid-firstmate-deep-analysis 來閱讀。README 明確可核對的入口是「firstmate --help」。執行時記錄命令版本、設定檔位置、輸入內容、標準輸出與錯誤訊息；若該步驟需要外部服務或特定權限，也把實際回應和清理結果分開保存。這些記錄能把文件描述與本機結果對上，未被 README 說明的行為則保留為未知。

第 6 節的實作核對可再觀察 firstmate 的輸出檔、服務日誌或終端回應，並將成功與失敗案例分開。若 README 沒有指定預設值，便以實際設定明確記錄，而不是推測 kunchenguid-firstmate-deep-analysis 的行為。

firstmate 第 6 節的核對紀錄還應包含執行環境、輸入大小、完成時間與退出狀態。對 kunchenguid-firstmate-deep-analysis 而言，這些欄位可用來比較兩次執行是否真的走過相同路徑；若輸出只在畫面短暫出現，應另存終端記錄，若產生檔案則記錄相對路徑與檔案內容摘要。

可選的 secondmates、X 模式和授權（kunchenguid-firstmate-deep-analysis-7）

兩個可選功能擴充了核心。持久化的 secondmates 是普通的直接下屬，在自己的隔離 firstmate 主目錄中執行，可以在同一台機器上，也可以作為整個主目錄放在可透過 SSH 存取的主機上；README 表示更新和復原受到保護，不可用的遠端路由永遠不會變成本地替代。X 模式透過一個本地 .env 權杖選擇啟用，讓大副回答公開的 @myfirstmate 提及，透過與聊天請求相同的生命週期處理可逆的提及請求，並在七天內發布最多三條公開安全的完成後續訊息，上線前會在本地記錄乾執行預覽。該儲存庫以 MIT 授權發布，版權歸 Kun Chen 所有。授權授予使用、複製、修改、合併、發布、散佈、再授權和出售軟體副本的權利，並明確聲明不提供擔保：軟體按現狀提供，不提供任何形式的保證。授權文字沒有提及支援、安全狀態或生產就緒性。

針對 firstmate，第 7 節應連同專案識別字 kunchenguid-firstmate-deep-analysis 來閱讀。README 明確可核對的入口是「firstmate --help」。執行時記錄命令版本、設定檔位置、輸入內容、標準輸出與錯誤訊息；若該步驟需要外部服務或特定權限，也把實際回應和清理結果分開保存。這些記錄能把文件描述與本機結果對上，未被 README 說明的行為則保留為未知。

第 7 節的實作核對可再觀察 firstmate 的輸出檔、服務日誌或終端回應，並將成功與失敗案例分開。若 README 沒有指定預設值，便以實際設定明確記錄，而不是推測 kunchenguid-firstmate-deep-analysis 的行為。

firstmate 第 7 節的核對紀錄還應包含執行環境、輸入大小、完成時間與退出狀態。對 kunchenguid-firstmate-deep-analysis 而言，這些欄位可用來比較兩次執行是否真的走過相同路徑；若輸出只在畫面短暫出現，應另存終端記錄，若產生檔案則記錄相對路徑與檔案內容摘要。

編輯結論

適合工作內容與 firstmate README 所列範圍相符，且能維護其依賴、設定與權限的團隊；不適合把文件未承諾的相容性、效能或安全結果當成既定事實。先在隔離環境執行「firstmate --help」，保存版本、輸入、輸出、錯誤與清理結果，再依這個專案的實際表現決定是否納入正式流程。

官方來源

1. Official README
2. Project repository