The GitHub Blog
·
释放Copilot代码审查的全部潜力：掌握您的指令文件
内容提要
Copilot代码审查（CCR）实现自动化代码审查，确保项目符合团队标准。新增对copilot-instructions.md及特定路径*.instructions.md文件的支持，允许用户自定义Copilot行为。有效指令应简洁、结构清晰，并包含示例代码。避免不支持的指令，如修改Copilot评论格式或请求执行其他任务。
关键要点
-
Copilot代码审查（CCR）实现自动化代码审查，确保项目符合团队标准。
-
新增对copilot-instructions.md及特定路径*.instructions.md文件的支持，允许用户自定义Copilot行为。
-
有效指令应简洁、结构清晰，并包含示例代码。
-
避免不支持的指令，如修改Copilot评论格式或请求执行其他任务。
-
使用简洁的指令，避免长文件导致不一致行为。
-
使用标题和项目符号保持信息组织，便于Copilot处理。
-
将语言特定规则放入*.instructions.md文件，并使用applyTo前言属性针对特定语言。
-
为Copilot代码审查或编码代理专门设置规则，使用excludeAgent前言属性防止读取。
-
有效指令文件应包含清晰标题、目的声明、指南列表、最佳实践建议和示例代码块。
-
避免尝试更改Copilot评论的用户体验或格式，或请求执行代码审查以外的任务。
-
提供指令文件的推荐结构，包括命名约定、代码风格、错误处理和测试等部分。
-
新用户可通过将Copilot添加为拉取请求的审阅者来开始使用Copilot代码审查。
-
可以创建copilot-instructions.md文件或路径特定的*.instructions.md文件来自定义指令。
-
使用Copilot编码代理编辑现有指令文件，确保保留原意并去除不支持的内容。
延伸解读
指令文件的重要性
在使用Copilot代码审查时，指令文件的结构和内容直接影响其效果。有效的指令应简洁明了，包含示例代码和清晰的标题，以便Copilot能够准确理解并执行。避免冗长的段落和不必要的复杂性，以提高代码审查的效率。
避免常见误区
在编写指令文件时，需注意避免不支持的指令，例如试图修改Copilot评论的格式或请求其执行代码审查以外的任务。这些尝试不仅无效，还可能导致Copilot的行为不一致，影响代码审查的质量。
路径特定指令的应用
使用路径特定的*.instructions.md文件可以针对特定语言或项目需求进行定制化设置。通过applyTo前言属性，可以确保指令仅适用于特定文件类型，从而提高代码审查的针对性和有效性。
延伸问答
Copilot代码审查的主要功能是什么？
Copilot代码审查（CCR）实现自动化代码审查，确保项目符合团队标准。
如何创建自定义的指令文件以优化Copilot的行为？
可以创建copilot-instructions.md文件或路径特定的*.instructions.md文件来自定义指令。
有效的指令文件应包含哪些元素？
有效指令文件应包含清晰标题、目的声明、指南列表、最佳实践建议和示例代码块。
使用Copilot代码审查时应避免哪些常见错误？
应避免尝试更改Copilot评论的用户体验、请求执行代码审查以外的任务，以及包含外部链接。
如何确保Copilot代码审查遵循我的指令？
使用简洁、结构清晰的指令，并包含示例代码，以提高Copilot遵循指令的可能性。
Copilot代码审查支持哪些文件格式？
Copilot代码审查支持copilot-instructions.md和特定路径的*.instructions.md文件。
