AgentCrew:面向AI編碼代理的Markdown優先作業系統
AgentCrew是一種對話優先、Markdown優先的編碼代理方法論,將單一聊天會話轉化為有角色分工、任務路由、質量門禁和人工審批的團隊流程。它透過純Bash分類器識別任務型別和風險等級,支援快速通道和完整通道兩種工作流,並內建安全規則防止代理自動合併程式碼或繞過審查。
AgentCrew是一個創新的開源專案,旨在解決當前AI編碼代理在軟體開發中的核心痛點:單一會話上下文通常試圖完成所有工作——從範圍界定、實現、測試到審查,甚至自我批准,這與真實軟體團隊的實踐背道而馳。專案創始人指出,同一模型既編寫錯誤又作為唯一審查者,這種模式無法保證程式碼質量。
AgentCrew的核心設計理念是“對話優先、Markdown優先”。它並非一個守護程序或CI替代品,而是一個方法論體系,現有編碼代理(如Claude Code、Codex、Cursor等)可以載入為指導檔案。其工作流程包括:純Bash分類器對請求進行分類(識別任務型別、風險等級、工作通道、可能涉及的技能和質量門禁),然後選擇合適的工作通道——快速通道適用於低風險任務(如拼寫修復、簡單文件更新),完整通道適用於高風險任務(如認證變更、資料庫遷移、安全敏感程式碼)。
在角色分工方面,AgentCrew定義了多種角色:顧問(Advisor)幫助推理,產品經理(PM)澄清範圍,開發者(Developer)專注實現,測試員(Tester)驗證行為,審查員(Reviewer)檢查正確性和風險,安全性審查員(Security Reviewer)關注敏感路徑,UX審查員審查互動質量,文件代理(Documentation Agent)更新文件,釋出經理(Release Manager)準備釋出。這些角色並非模擬人類,而是讓代理在不同工作階段應用不同的約束。
AgentCrew還包含專案本地狀態管理(.agent-state/目錄),用於儲存當前任務、工作計劃、已做出的決策、測試報告、審查報告和會話檢查點。它強調“壓縮而非存檔”的記憶原則。專案預設功能可根據技術棧調整方法論,例如Python Web服務、TypeScript前端、Rust CLI等。
安全規則是AgentCrew的核心:代理不得合併自己的工作、不得繞過分支保護、不得使用git push --force(除非使用者明確要求並理解風險)、不得隱藏測試失敗、不得聲稱測試透過而未執行、不得提交金鑰、不得進行無關更改、不得靜默擴大範圍、不得將自己的審查視為最終批准。生產工作上線前必須獲得人工批准。
安裝流程簡單:克隆倉庫到專案外部,執行安裝指令碼,然後開啟正常編碼代理即可。專案強調不改變使用者的工作方式——使用者繼續與代理對話,而AgentCrew在後臺提供路由系統、角色指令、交接格式、狀態工件和批准門禁。這個方法論旨在讓編碼代理更值得信任、更易於審查,並真正融入實際開發工作。