如何撰写出色的 agents.md：来自2500多个代码库的经验教训
原文英文，约1900词，阅读约需7分钟。
📝
内容提要
GitHub Copilot的新功能允许用户在agents.md文件中创建自定义代理，适用于技术写作、质量保证和安全分析等领域。成功的代理需明确角色、具体命令和边界，避免模糊描述。分析表明，提供具体任务和清晰示例的代理表现更佳。
🔎
延伸解读
明确角色的重要性
在创建agents.md文件时，明确代理的角色至关重要。成功的代理不仅仅是模糊的助手，而是具备特定专业技能的专家。通过清晰地定义代理的任务和技能，可以显著提高其在实际应用中的表现。
设定边界以防错误
为代理设定明确的边界可以有效防止潜在的错误和损害。例如，指明哪些文件或目录绝对不能修改，可以避免意外的代码损坏或数据泄露。这样的限制不仅保护了项目的完整性，也提高了代理的可靠性。
具体化技术栈的必要性
在agents.md中具体说明技术栈，包括版本和关键依赖，有助于代理更好地理解项目环境。这种详细的信息可以确保代理在执行任务时，能够使用正确的工具和方法，从而提高工作效率。
❓
Q&A
如何在agents.md文件中定义自定义代理？
在agents.md文件中定义自定义代理时，需要明确代理的角色、具体命令和边界，避免模糊描述。
成功的代理文件应该包含哪些核心领域？
成功的代理文件应覆盖命令、测试、项目结构、代码风格、git工作流和边界六个核心领域。
为什么大多数代理文件会失败？
大多数代理文件失败的原因是描述过于模糊，缺乏具体的角色和任务定义。
如何提高代理的表现？
提高代理表现的方法包括提供具体任务、清晰示例和明确的边界，确保命令放在前面。
创建代理时应该避免哪些常见错误？
创建代理时应避免创建通用助手，应该选择简单任务并设定明确的边界。
可以使用Copilot生成哪些类型的代理？
可以使用Copilot生成文档代理、测试代理、lint代理等多种类型的代理。
🏷️
