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工具，同時保持程式碼審查的嚴謹性和透明度。