咨询：在Visual Studio 2022中用Copilot生成代码文档的有效指令

问题场景 #

我在编写名为「AllNewOpportunities」的方法时，输入指令「//document AllNewOpportunities」，得到的结果仅为Power Apps Web API相关文档链接，请问是否存在特定指令（魔法词），可以让Copilot为该方法生成代码文档？

可行指令示例 #

• 明确指定文档风格与内容：//为AllNewOpportunities方法编写XML注释风格的代码文档，包含功能描述、参数说明、返回值类型、异常场景
• 结合方法功能细化要求：//生成查询新商机的AllNewOpportunities方法的详细文档，涵盖用途、输入参数、返回结果、使用示例
• 直接要求完整文档：//详细描述AllNewOpportunities方法的功能、参数定义、返回值格式及调用注意事项

关键提示 #

Copilot对指令的清晰度依赖较高，模糊的指令容易返回通用文档链接。补充方法的业务背景（比如该方法用于Power Apps中查询新商机数据）、期望的文档格式（如XML注释、Javadoc），能大幅提升生成结果的准确性。

内容的提问来源于stack exchange，提问作者Ofer Gal