AGENTS.md 文件中的配置味道：配置 编码智能体 时的常见错误

编码智能体 越来越多地用于自动化软件工程任务。为了指导它们的行为，这些代理通常依赖于配置文件，通常名为 AGENTS。 md 或克劳德。 md，提供有关架构、工作流程、编码约定和测试实践的说明。尽管它们的重要性日益增加，但人们对影响这些文件的定义和维护的常见问题知之甚少。在本文中，我们提出了编码代理配置文件的第一个气味目录。为了识别此类气味，我们首先进行了灰色文献回顾和存储库挖掘分析。结果，我们确定了六种配置气味，并提出了自动启发式方法来检测它们。为了评估所提出的气味的普遍程度，我们分析了 100 个包含 AGENTS 的流行开源存储库。 md 或克劳德。 md 文件。我们的结果表明配置异味很普遍。 Lint Leakage 是最常见的气味，影响了 62% 的文件，其次是 Context Bloat (42%) 和 Skill Leakage (35%)。我们进一步表明，几种气味经常同时出现，特别是上下文膨胀、技能泄漏和指令冲突。