Agent-trace：一個用於追蹤AI生成程式碼的標準格式

Agent Trace 是一個開放規範，旨在為AI生成的程式碼提供標準化的追蹤格式。隨著AI代理編寫越來越多的程式碼，瞭解程式碼來源變得至關重要。該規範定義了一種供應商中立的格式，用於在版本控制的程式碼庫中記錄AI貢獻與人類作者身份。

Agent Trace 的核心是追蹤記錄（Trace Record），這是一個JSON物件，必須包含版本、唯一識別符號、時間戳和檔案陣列。它可以選擇性地包含版本控制系統資訊（VCS）、生成該追蹤的工具以及額外的後設資料。追蹤記錄支援檔案級別和行級別的歸因，允許精確指出某段程式碼是由人類、AI還是混合貢獻產生的。

歸因是基於對話（conversation）分組的，每個對話關聯一個貢獻者和多個行範圍。每個範圍由起始行和結束行定義，並可選地包含內容雜湊，以便在程式碼移動時仍能追蹤。貢獻者型別包括人類（human）、AI（ai）、混合（mixed）和未知（unknown）。AI貢獻可以進一步指定具體的模型識別符號，如anthropic/claude-opus-4-5-20251101。

該規範目前支援Git、Jujutsu和Mercurial等版本控制系統。透過vcs欄位，可以記錄提交雜湊或變更ID。Agent Trace 的設計注重可擴充套件性，允許供應商透過反向域名記法在後設資料中新增自定義欄位，例如dev.cursor。規範本身使用語義化版本控制，主要版本更新可能引入破壞性更改。

Agent Trace 不用於追蹤程式碼所有權、訓練資料來源或程式碼質量評估。它的目標是提供一個互操作的標準，讓任何合規工具都能讀寫歸因資料。參考實現已提供在GitHub倉庫中，包括儲存層和鉤子整合，適用於Cursor或Claude Code等AI編碼代理。

目前該規範處於RFC階段（0.1.0版本），日期為2026年1月。社群正在徵集反饋，未來可能根據實際使用情況調整規範。