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月。社區正在徵集反饋，未來可能根據實際使用情況調整規範。