跳到主要內容
maxstudioNews
商業DEV Community (Claude Code)約 8 分鐘

兩個 AI 程式碼代理協作:如何保持同步並避免衝突

當多個 AI 程式碼代理在同一程式碼庫上平行工作時,即使 Git 合併乾淨,也可能產生決策衝突。本文探討了這種「決策漂移」問題,並強調了共享決策記憶的重要性。為了解決這些挑戰,文章建議明確任務依賴、將探索與決策分離,並利用 Lockstep 等工具來確保所有代理都基於一致的真相進行工作。

兩個 AI 程式碼代理協作:如何保持同步並避免衝突
圖片來源:DEV Community (Claude Code)

一個問題要求:將 POST /login 更名為 /session 並移除舊路由。另一個問題要求:更新使用者註冊流程,在電子郵件驗證後呼叫驗證端點。兩位工程師各負責一個問題,都使用 AI 程式碼代理,且兩個代理都快速執行。

第一個代理修改了伺服器、SDK 和測試。第二個代理則開啟一個獨立分支,發現客戶端仍呼叫 /login,並保留了它,因為這是它所看到的程式碼。每個代理都做了合理的工作,但它們共同產生了矛盾。

這就是多代理程式碼開發令人不安之處:平行執行並不會產生共同的理解,反而會創造更多理解分歧的點。關於此問題的單代理版本,以及解決此問題的記憶層,請參閱 AI 程式碼代理記憶指南。

人們談論多個代理在一個儲存庫上工作,彷彿儲存庫是共享的大腦。但它不是,它只是共享的輸出。代理 A 看到它的提示詞、它的分支、它開啟的檔案,以及某人碰巧包含的決策。代理 B 看到不同的提示詞、不同的分支,以及不同的程式碼片段。

即使兩者都從相同的提交開始,它們的上下文也會在開始時立即分歧。儲存庫可以告訴它們存在兩個路由,但通常無法告訴它們團隊在客戶遷移後故意停用了其中一個。它可以顯示一個錯誤的功能旗標,但無法顯示產品部門因為支援該功能會破壞新的定價模型而將其移除。

缺少「為什麼」正是代理開始獨立猜測的原因。Anthropic 關於上下文工程的指南指出了核心重點:有效的代理取決於找到並維護正確的上下文,而不僅僅是填充更大的視窗。擁有多個代理時,你不是在維護一個有用的上下文,而是在維護多個,同時每個代理都在改變其他代理所依據的基礎。

Git 擅長告訴你兩個分支何時更改了同一行。大多數多代理故障則不那麼「禮貌」。一個代理將試用期從 14 天改為 7 天,另一個代理重寫了帳單電子郵件,但仍承諾 14 天,檔案不同,合併乾淨。

一個代理因為功能被移除而刪除了一個匯出,另一個代理為此功能添加了一個新的設定畫面,套件不同,合併乾淨。一個代理更改了 API 回應的結構,第二個代理根據舊的結構更新了前端,第三個代理看到這兩個分支,認為不匹配是偶然的,並添加了一個沒人想要的相容層。

程式碼沒有衝突,但決策卻衝突了。這就是平行速度下的決策漂移。這不僅影響解決分支的開發人員:工程主管將審查變成了一項上下文重建工作,而產品人員則看到舊範圍重新出現或定價洩漏到不一致的地方。

一個大型任務不會僅僅因為你產生更多代理就變成平行任務。好的平行任務應具有低重疊性和清晰的輸出,例如:調查目前的驗證流程、在一個工作樹中實作後端權杖輪換、在後端合約被接受後更新行動客戶端處理、針對已接受的回應結構編寫整合測試。

「改進驗證」或「修復 API 和 UI」不是平行任務;它們是邀請兩個代理制定重疊計畫。Claude Code 的代理團隊指南指出,當任務可以獨立進行且協調能增加價值時,團隊運作最佳。每個隊友都有自己的上下文視窗,且團隊比子代理產生更高的權杖和協調成本。

從少數代理開始,只有當工作確實可以分離時才增加更多。如果一個主要代理只需要完成有限的研究或驗證工作,子代理通常比獨立的隊友更便宜。來源:Claude Code 代理團隊。

Git 工作樹為每個代理提供獨立的工作目錄和分支,同時共享儲存庫歷史,例如:git worktree add ../repo-auth -b agent/auth 和 git worktree add ../repo-client -b agent/client。

Claude Code 可以在工作樹中啟動一個隔離的會話,而 Cursor 的平行代理工作流程也出於同樣的原因使用工作樹:一個代理的編輯不應覆蓋另一個代理的工作目錄。隔離可以防止檔案系統衝突,但不能防止語義衝突。工作樹解決了代理在哪裡編輯的問題,而不是團隊同意了什麼。來源:Claude Code 工作樹和 Cursor 工作樹。

依賴關係比同時開始時間更重要。代理 B 可以在合約最終確定之前調查客戶端,但不應硬編碼猜測的回應結構。Claude Code 代理團隊包含一個帶有依賴追蹤的共享任務列表;問題追蹤系統或任何其他任務系統也適用,只要每個代理都能看到誰擁有什麼以及什麼必須先完成。

有限的問題、指定的目錄和規劃代理都是有用的控制措施。它們解決了工作的所有權問題,而不是真相的一致性問題。任務板可以說明誰負責使用者註冊,但它沒有說明為什麼使用者註冊必須等待電子郵件驗證。

規劃者可以將遷移分成五個步驟,但它不知道舊路由絕不能恢復,除非該決策到達其上下文。代理之間的訊息可以保持一次運行的協調,但它們會隨著運行的結束而消失,下一個代理又會從零開始。

Anthropic 關於其多代理研究系統的描述,闡述了委派範圍、協調平行路徑以及將結果整合的工作。程式碼開發增加了另一個限制:結果不是一次性組裝的報告,而是一個活生生的產品,今天的代理繼承了昨天代理所做的每一個決策。交接不能只傳遞程式碼,它必須傳遞意圖。

當一個代理發現影響另一個工作流的事項時,它應該立即更新共享任務,而不是在合併時。例如,驗證合約更新:刷新端點現在返回 retry_after_ms;該欄位僅在永久性失敗時可為空;行動客戶端不得推斷重試延遲;已在決策 AUTH-12 中接受;後端分支測試通過 pnpm test auth。

有用的交接應說明變更、受影響的介面和消費者、其狀態(已發現、已提議或已接受)、負責人或決策參考、已執行的測試以及剩餘風險。

幾個代理可以平行探索替代方案,這很有用。在實作路徑分歧之前,它們的發現應該返回給負責人。代理進行調查或提出建議,主管總結選項和權衡,負責人接受一個合約或架構選擇,該決策成為共享記錄中的最新內容,實作任務解除阻礙。

沒有這個把關,第一個提交程式碼的代理會默默成為決策者,而後來的代理則會圍繞一個偶然的選擇進行規範化。

給每個代理整個儲存庫是必要的,但程式碼是決策的證據,而不是可靠的記錄。代理從實作中反向工程意圖,並可能得出不同的結論。將所有內容放入 AGENTS.md 對於穩定的指令很有用,但對於不斷變化的產品和工程呼叫流則效果不佳。

檔案會越來越大,過時的規則未被標記,並且每個代理無論規則是否影響其工作,都需支付上下文成本。讓代理閱讀維基,但哪一頁?哪個版本?文件儲存庫不是簡報系統。相關決策必須在代理編寫程式碼之前到達代理。

添加更多測試至關重要,但它們只保護某人編碼的決策,並且獨立的單元測試套件可能通過,而組合合約卻失敗。使用一個規劃代理可以減少運行中的重疊,但它會成為另一個臨時記憶邊界,除非其決策持續存在且未來的代理可以檢索它們。

Microsoft 在儲存庫記憶和儲存庫級別規劃方面的工作也指向同一方向:當代理能夠傳遞有用的知識並跨依賴變更進行推理時,儲存庫規模的工作會得到改善。但團隊需要的不是程式碼地圖,而是程式碼應遵循的呼叫記憶。

共享的記錄不足夠,一堆摘要也不足夠。有用的決策記憶具有形狀,包含結論,例如:「試用期在電子郵件驗證後開始」,而不是三頁需要再次解釋的對話。它還應包含「為什麼」,因為沒有原因,未來的代理無法判斷當程式碼周圍發生變化時,該決策是否仍然適用。

被拒絕的替代方案也應記錄下來。如果團隊曾考慮在註冊時開始試用,但因一次性帳戶扭曲了啟用率而拒絕,請記錄下來,否則代理將重新發現這個想法並將其呈現為新的。決策的範圍也很重要,它影響哪些模組、流程或產品介面?範圍讓系統可以檢索相關的小型簡報,而不是將整個公司歷史傾倒到每個上下文視窗中。

負責人和狀態也很關鍵,誰做出了決定?它是啟用中、提議中還是已替換?共享記憶應使代理保持一致,而不是將每個臨時建議都變成政策。替換鏈也很重要:當七天再次變成十四天時,舊條目應保持可見並標記為已取代,連結到新的呼叫及其原因。無聲的重寫會創建一個無人能審計的記憶。

一個代理的本地記憶無法扮演這個角色:其他代理看不到它,團隊也無法審查它。已接受的選擇需要被提升到共享記錄中。捕捉決策只是系統的一半。在代理編輯使用者註冊之前,它應該收到影響使用者註冊的活躍決策:試用期何時開始、需要哪些驗證,以及最近被替換的內容。

在另一個代理編輯帳單電子郵件之前,它應該收到重疊的定價和試用決策。它們不需要相同的提示詞,它們需要一套一致的真相,在其工作重疊的地方。如果新的實作與已接受的選擇衝突,代理應該停止並指出衝突,而不是默默更新架構。

一位主管,無論是人類還是代理,負責整合而不僅僅是合併。這包括確認已接受的介面和決策、首先合併最低層次的依賴項並運行其測試、重新基準化依賴分支並運行跨邊界測試、檢查交接和決策指標是否最新,以及工作完成後關閉臨時交接。

乾淨的 Git 合併並不能證明結果的一致性。對於高風險工作,應讓代理在實作前進行規劃;Claude Code 代理團隊支援計畫審批,因此主管可以在檔案更改之前審查方法。關於如何將一位工程師的代理所學知識與團隊其他成員共享的原生方法,請參閱 Claude Code 團隊記憶。

Lockstep 是為使用 AI 程式碼代理的團隊提供的共享決策記憶層。負責人批准從 Slack、文件、工單和 PR 中捕獲的決策;Lockstep 保留了決策的「為什麼」和替換歷史,根據影響範圍對每個決策進行排名,並在任何 MCP 相容代理採取行動之前,透過 get_product_context 向其簡報。

PR 檢查會標記可能與已批准決策衝突的變更(預設為警告;阻擋是可選的)。工作樹使編輯分離,任務使所有權清晰,測試檢查組合結果。Lockstep 確保每個代理都基於相同版本的真相工作。相關:如何在 Cursor 和 Claude Code 之間共享記憶。

Share

覺得值得一看?分享給朋友。

以上為 AI 自動翻譯導讀。原文版權歸 DEV Community (Claude Code) 所有, 建議透過「閱讀原文」前往原始網站,以取得最完整資訊並支持原作者。

Newsletter

不用每天追,AI 重點每週寄給你

43 個來源、每 2 小時更新,太多看不完。電子報每週挑最值得看的幾則,附上 Max 的看法。

每週一封。Email 只用來寄電子報,每封信都能一鍵退訂。