AI-DECLARATION.md：聲明代碼中AI使用情況的開源標準
AI-DECLARATION.md 是一個開源規範，通過在倉庫中聲明AI參與程度來提升透明度。它定義了從無AI到完全自動化的六個等級，並允許針對設計、實現、測試等開發過程進行細化聲明。該規範強調以結構化方式明確AI使用情況，旨在建立開發者社區的可信契約。
文章情報
要點
- AI-DECLARATION.md 提供結構化聲明方式，讓項目透明展示AI使用程度
- 等級從 none 到 auto 分六級，可針對不同過程細化
- 支持按文件或目錄組件聲明AI參與
- 項目鼓勵社區參與翻譯和規範改進
為甚麼重要
這條新聞值得關注，因為AI-DECLARATION.md 提供結構化聲明方式，讓項目透明展示AI使用程度。
技術影響
可能影響模型選型、推理成本、產品能力和評測基準。
AI-DECLARATION.md 是一個開源的規範標準，旨在幫助軟件項目清晰、結構化地聲明人工智能（AI）在代碼開發中的使用情況。隨着AI代碼生成工具（如LLM）的普及，代碼的來源和透明度成為開發者社區關注的焦點。該規範的核心目標並非鼓勵或限制AI的使用，而是通過標準化的聲明文件，讓項目維護者和貢獻者能夠明確瞭解項目中AI的參與程度，從而增強互信與協作。
規範規定，每個使用該聲明的倉庫必須包含一個名為 AI-DECLARATION.md 的文件，該文件採用YAML前端元數據（frontmatter）定義結構化字段，後跟一個必需的 ## Notes 部分用於人工説明。最少需要聲明 version（版本號）、level（整體參與等級）和 Notes 部分。等級從低到高分為六級：none（無AI參與）、hint（AI被動提示）、assist（AI輔助完成部分任務）、pair（人機平等協作）、copilot（AI主導但需人類確認）、auto（AI完全自主完成任務）。此外，還可以通過 processes 字段為設計、實施、測試、文檔、審查、部署等具體開發過程分別指定等級，未指定的過程默認為 none。components 字段則允許針對特定文件或目錄聲明等級，實現更精細的控制。
規範提供了多個示例場景。最簡單的聲明只需版本和等級兩項，如 level: none 表示未使用任何AI工具，或 level: auto 並使用 ## Notes 説明使用了Claude Code生成整個應用。更復雜的場景包括：全局等級為 auto，但測試過程僅設為 copilot；或者全局等級為 level: auto，而 src/helpers 目錄完全由AI生成，其他部分為人工編寫。這些示例展示了規範的靈活性和實用性。
除了核心規範，該項目還提供了用於README的徽章，方便快速標識AI聲明等級。FAQ部分解答了一些常見問題：如果謊報則失去聲明意義；鼓勵開發工具自動生成和解析聲明；歡迎社區貢獻翻譯（如新增 README_es.md）；規範本身是開源的，歡迎通過PR提出改進建議。項目的標誌是易經中的中孚卦（䷼），象徵內在的真實。
AI-DECLARATION.md 的出現為AI輔助開發時代提供了一種可信的溝通機制，讓開發者能夠更自如地選擇和使用AI工具，同時保持代碼審查的嚴謹性和透明度。