关于 Copilot 提交消息生成
Copilot 的提交信息生成是一项由 AI 支持的功能,借助此功能,你可以根据在 GitHub.com 上选择提交的更改,自动创建提交信息摘要(标题)和描述。 要了解 GitHub Desktop 中的提交信息生成功能,请参阅“GitHub Desktop 中 GitHub Copilot 的负责任使用”。
当用户使用 GitHub 的 Web 界面提交对文件的更改时,Copilot 会扫描代码更改,并提供建议摘要(标题)和简要的更改描述。 将更改提交到分支之前,你可以查看并编辑 Copilot 建议的标题和描述****。
GitHub.com 中 Copilot 生成的提交消息的唯一支持语言是英语。
Copilot 提交消息生成采用简单的提示流,利用 Copilot API,并使用通用大型语言模型,无需额外的训练模型。
在 GitHub.com 中单击“Commit changes”按钮时,系统会调用 Copilot API 生成建议文本,并填入摘要与描述框****。 文本完成请求在请求 Copilot 生成准确所选更改的提交消息建议的提示中包含来自仓库不同文件中有关这些更改的信息。 随后出现的响应用于填充摘要和描述框。 然后,可以查看建议的消息,必要时进行编辑,然后将其提交。
Copilot 提交消息生成用例
Copilot 提交消息生成旨在简化作者工作流,以便在总结更改时节省时间并维护明确的提交历史记录。 对于许多用户而言,这有助于在提交大型更改时节省时间。 作者可在最终确认前审核并修改建议内容,随后手动将更改提交到分支。 该功能已无缝集成到提交工作流中,可带来更流畅的体验。
改进 Copilot 提交消息生成
为了增强体验并解决 Copilot 提交消息生成的某些限制,你可以采用各种措施。 有关限制的详细信息,请参阅 Copilot 提交消息生成的限制。
使用 Copilot 提交消息生成作为工具,而不是替代
该功能旨在补充,而非取代人工起草提交消息的工作。 提交消息建议的质量将取决于代码更改的质量和所更改文件中的上下文。 你仍有责任审查和评估你创建的提交中信息的准确性。
提供反馈
如果在 Copilot 生成提交消息时遇到任何问题或限制,可通过社区讨论提交反馈。 这可以帮助开发人员改进该工具并解决任何问题或限制。
Copilot 提交消息生成的限制
根据操作系统和输入数据等因素,你在 GitHub.com 中使用 Copilot 生成提交消息时,可能会遇到准确度表现不一的情况。 以下信息旨在帮助你了解系统限制以及有关性能的关键概念,因为它们适用于 Copilot 提交消息生成。
作用域受限
Copilot 提交消息生成在定义的边界内运行,可能难以处理复杂的代码更改、较短的差异窗口或最新开发的编程语言。 它提供的建议质量可能会受到训练数据的可用性和多样性影响。 例如,与不太热门的语言相比,有关 Python 等记录详尽语言的查询可能会得到更准确的响应。
响应不准确
Copilot 可以学习的输入和上下文越多,输出就越好。 但是,由于该功能相当新,因此生成的摘要需要一段时间才能达到精确度。 与此同时,可能会出现生成的摘要不够准确的情况,需要用户在保存和发布提交时对其进行修改。 此外,还存在“幻象”风险,即 Copilot 生成不准确的语句。 由于这些原因,审查成为一项要求,我们的团队强烈建议仔细审查输出。
复制提交消息内容
由于提交消息是仓库中所做更改的摘要,如果更改内容中包含有害或冒犯性词语,摘要中也有可能包含这些词语。
潜在的偏差和错误
Copilot 提交消息生成的训练数据源自现有在线资源。 请务必注意,这些来源可能包含参与训练数据的个人的偏见和错误。 Copilot 的提交消息生成可能会无意中延续这些偏见与错误。
选择退出
希望停用 Copilot 提交消息生成的用户,可通过 GitHub.com 中的 Copilot 设置页面进行操作。
其他阅读材料
- GitHub 附加产品和功能条款
- GitHub Copilot 信任中心