
作者 | Robert Krzaczyński
譯者 | 田橙
Cursor 近日公布了 Agent Trace 開放規(guī)范草案,目標(biāo)是解決 AI 生成代碼在軟件項(xiàng)目中的歸屬與標(biāo)注問題。該提案以 RFC 形式發(fā)布,定義了一種廠商中立的格式,用于在版本控制系統(tǒng)中記錄 AI 與人類協(xié)作產(chǎn)生的代碼貢獻(xiàn)。
基于其在 AI 輔助編程工具方面的實(shí)踐經(jīng)驗(yàn),Cursor 發(fā)現(xiàn),代碼變更過(guò)程中對(duì)上下文的追蹤能力仍然明顯不足。以常見的 git blame 等工具為例,它們只能顯示某一行代碼“何時(shí)被修改”,卻無(wú)法說(shuō)明這次修改是由人類完成、由 AI 完成,還是二者協(xié)作的結(jié)果。Agent Trace 正是為了解決這一缺口,試圖以結(jié)構(gòu)化、可互操作的方式捕獲這些關(guān)鍵信息。
從技術(shù)角度看,Agent Trace 是一套數(shù)據(jù)規(guī)范,使用基于 JSON 的 trace record(追蹤記錄)來(lái)關(guān)聯(lián)具體的代碼范圍,以及背后的對(duì)話過(guò)程和參與者。代碼貢獻(xiàn)可以在文件級(jí)或行級(jí)進(jìn)行追蹤,按會(huì)話進(jìn)行分組,并被標(biāo)注為“人類”、“AI”、“混合”或“未知”。該模式還支持為 AI 生成的代碼附加可選的模型標(biāo)識(shí),從而在不綁定具體廠商的前提下,實(shí)現(xiàn)更精確的歸屬記錄。
![]()
在設(shè)計(jì)上,這一規(guī)范刻意保持了對(duì)存儲(chǔ)方式的“中立性”。Cursor 并未規(guī)定追蹤記錄必須存放在哪里,開發(fā)者可以根據(jù)自身需求,將其保存為普通文件、git notes、數(shù)據(jù)庫(kù)記錄,或采用其他機(jī)制。Agent Trace 同時(shí)支持多種版本控制系統(tǒng),包括 Git、Jujutsu 和 Mercurial,并引入了可選的內(nèi)容哈希,用于在代碼被移動(dòng)或重構(gòu)后,依然能夠追蹤其原始?xì)w屬。
可擴(kuò)展性是 Agent Trace 的核心設(shè)計(jì)目標(biāo)之一。各廠商可以通過(guò)命名空間鍵(namespaced keys)附加額外的元數(shù)據(jù),而不會(huì)破壞規(guī)范的兼容性。同時(shí),該規(guī)范刻意回避了對(duì) UI 形式、代碼所有權(quán)語(yǔ)義的定義,也不試圖評(píng)估代碼質(zhì)量或追溯訓(xùn)練數(shù)據(jù)來(lái)源,而是將關(guān)注點(diǎn)嚴(yán)格限定在“代碼歸屬”和“可追溯性”本身。
Cursor 還提供了一份參考實(shí)現(xiàn),展示 AI 編程代理如何在文件發(fā)生變化時(shí),自動(dòng)捕獲并生成追蹤記錄。盡管示例基于 Cursor 自家的工具鏈,但其設(shè)計(jì)模式被明確定位為可復(fù)用方案,適用于其他編輯器和智能代理。
來(lái)自開發(fā)者社區(qū)的早期反饋,普遍強(qiáng)調(diào)了這一規(guī)范在代碼審查和調(diào)試流程中的潛在價(jià)值。一位 X 用戶評(píng)論道:
這才是真正在收拾 Agent 生成代碼的爛攤子。等不及在 Review 里用了。
另一位用戶則從可復(fù)現(xiàn)性的角度給予了肯定:
團(tuán)隊(duì)一旦搞不清 Agent 為啥跑偏,就會(huì)直接停工。Trace 解決了這個(gè)痛點(diǎn),開放得正好。
作為一份 RFC,Agent Trace 明確歡迎社區(qū)反饋,同時(shí)也有意保留了一些尚未解決的問題,例如在合并(merge)、變基(rebase)以及大規(guī)模代理驅(qū)動(dòng)代碼變更場(chǎng)景下應(yīng)如何處理。Cursor 將該提案定位為一個(gè)共同標(biāo)準(zhǔn)的起點(diǎn),而非終極答案,以應(yīng)對(duì) AI 代理在軟件開發(fā)流程中日益普及的現(xiàn)實(shí)趨勢(shì)。
https://www.infoq.com/news/2026/02/agent-trace-cursor/
聲明:本文為 InfoQ 翻譯,未經(jīng)許可禁止轉(zhuǎn)載。
特別聲明:以上內(nèi)容(如有圖片或視頻亦包括在內(nèi))為自媒體平臺(tái)“網(wǎng)易號(hào)”用戶上傳并發(fā)布,本平臺(tái)僅提供信息存儲(chǔ)服務(wù)。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.