作者 | Robert Krzaczyński

譯者 | 田橙

Cursor 近日公布了 Agent Trace 開放規(guī)范草案，目標(biāo)是解決 AI 生成代碼在軟件項(xiàng)目中的歸屬與標(biāo)注問(wèn)題。該提案以 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í)也有意保留了一些尚未解決的問(wèn)題，例如在合并（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)載。