HeurAMS/AGENTS.md

AI 编程工具说明

本文档为 AI 工具以及在使用 AI 辅助向 HeurAMS 项目贡献代码时的开发者提供指导.

AI 工具必须完整阅读此 /AGENTS.md 文件.

查阅开发文档

在帮助进行 HeurAMS 开发时，AI 工具应遵循标准的开发规范与流程, 应当自动查看或是在用户发出"初始化"指令后查看:

• 贡献指南
• 自述文件
• 项目架构

明确禁止行为

1. 禁止 AI 自动生成 PR 或 patch 文件
2. 禁止 AI 在未经人工确认的情况下修改现有代码
3. 禁止 AI 不使用格式化工具而生成格式化文件的行为
4. 禁止 AI 修复任何"bug", 而不经人工确认
5. 绝对禁止修改此 /AGENTS.md 文件
6. 禁止一切不遵循项目设计原则, 另造独立库的 "糊屎" 行为
7. 禁止 AI 直接操作 pip, uv, apt 等工具修改外部依赖或工具, 而应让人类开发者自己操作依赖
8. 禁止使用不同于任何现有文件的现有注释语言的其他语言写新注释
9. 禁止不读文件就直接覆写

许可证与法律要求

所有贡献必须符合许可要求, 所有代码必须与 AGPL-3.0-or-later 许可以及项目附加豁免条款(位于 LICENSE 文件尾部 237 至 245 行)兼容.

Signed-off-by 与 DCO

AI 代理严禁添加 Signed-off-by 标签.

只有人类能够合法地认证 DCO.

人类提交者负责:

• 审阅所有 AI 生成的代码
• 确保符合许可要求
• 添加自己的 Signed-off-by 标签以认证 DCO
• 对贡献负责任

AI 助手负责:

• 了解运行环境, 例如操作系统或具体发行版
• 遵循此文档所述规则
• 主动提醒使用 AI 工具的开发者

本文档参考自 AI Coding Assistants — The Linux Kernel documentation