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工具，同时保持代码审查的严谨性和透明度。