The GitHub Blog
·
如何撰写出色的 agents.md：来自2500多个代码库的经验教训
💡
原文英文，约1900词，阅读约需7分钟。
📝
内容提要
GitHub Copilot的新功能允许用户在agents.md文件中创建自定义代理，适用于技术写作、质量保证和安全分析等领域。成功的代理需明确角色、具体命令和边界，避免模糊描述。分析表明，提供具体任务和清晰示例的代理表现更佳。
🎯
关键要点
- GitHub Copilot的新功能允许用户在agents.md文件中创建自定义代理。
- 可以构建多个专业代理，如技术写作、质量保证和安全分析。
- 成功的代理需明确角色、具体命令和边界，避免模糊描述。
- 分析显示，提供具体任务和清晰示例的代理表现更佳。
- 成功的代理文件将命令放在前面，并提供实际代码示例。
- 设定明确的边界，告知AI哪些内容绝对不能触碰。
- 具体说明技术栈，包括版本和关键依赖。
- 覆盖六个核心领域：命令、测试、项目结构、代码风格、git工作流和边界。
- 提供一个优秀的agent.md文件示例，展示如何定义代理角色和命令。
- 构建代理时，选择简单任务，避免创建通用助手。
- 使用Copilot生成代理文件时，确保包含角色、命令和边界。
- 建议构建六个代理，包括文档代理、测试代理、lint代理等。
- 有效的自定义代理需要具体的角色和清晰的操作手册。
- 创建代理时，覆盖六个核心领域，并通过迭代不断完善。
❓
延伸问答
如何在agents.md文件中定义自定义代理？
在agents.md文件中定义自定义代理时，需要明确代理的角色、具体命令和边界，避免模糊描述。
成功的代理文件应该包含哪些核心领域？
成功的代理文件应覆盖命令、测试、项目结构、代码风格、git工作流和边界六个核心领域。
为什么大多数代理文件会失败？
大多数代理文件失败的原因是描述过于模糊，缺乏具体的角色和任务定义。
如何提高代理的表现？
提高代理表现的方法包括提供具体任务、清晰示例和明确的边界，确保命令放在前面。
创建代理时应该避免哪些常见错误？
创建代理时应避免创建通用助手，应该选择简单任务并设定明确的边界。
可以使用Copilot生成哪些类型的代理？
可以使用Copilot生成文档代理、测试代理、lint代理等多种类型的代理。
➡️
