Skip to main content

使用 GitHub Copilot 创建问题

使用 Copilot 根据自然语言或图像快速生成结构化的高质量问题,而无需手动填写每个字段。

谁可以使用此功能?

Anyone with a Copilot license can use Copilot to create issues.
Try Copilot for free

注意

此功能现为 公共预览版,可能会更改。

手动创建任务可能既重复又耗时。 借助 Copilot,你可以通过用自然语言提供提示,甚至上传屏幕截图来更快地创建议题。 Copilot 使用仓库的议题表单或模板填写标题、正文、标签、被分配者等。

你仍可控制整个过程。 可以在提交新议题之前查看并改进 Copilot 建议的内容。

使用 Copilot 创建问题

你可以从 Copilot 对话助手 的沉浸式视图创建问题。

  1. 前往 Copilot 对话助手 (https://github.com/copilot) 的沉浸式视图。

  2. 在提示框中,描述要创建的议题。

    如果向多个存储库贡献议题,请使用 repo-owner/repo-name 格式指定此议题的目标存储库。 如果不指定存储库,Copilot 将根据上次在其中创建议题的存储库推断存储库。

    例如:

    • 在 OWNER/REPOSITORY 中,创建功能请求来添加模糊匹配进行搜索。

    • 记录 500 错误的 bug。 当我尝试登录到站点时,这种情况总是发生。

    • 创建任务以将应用程序徽标背景更改为红色,并添加标签“需要设计评审”。

    注意

    只能使用 Copilot 在你已有权在其中创建问题的存储库中创建问题。 此功能不会更改访问权限,也不会绕过存储库权限。

  3. 或者,可使用下列方法之一在提示中包含图像:

    • 复制图像并将其粘贴到页面底部的提示框中。
    • 在提示框中单击 ,然后单击“Image”。 浏览到要附加的图像文件,选择它并单击“Image”
    • 将图像文件从操作系统的文件资源管理器拖放到提示框中。

    粘贴或上传图像后,可以向提示添加文本,例如:Create an issue because this error appears when trying to reset a password.

  4. Copilot 会起草一个议题,其中包括:

    • 建议的标题。

    • 所需更改的详细信息。

      如果存储库有议题表单或模板,Copilot 将根据你的提示选择适当的表单或模板。 如果没有表单或模板,Copilot 将为议题详细信息创建基本议题正文。

      如果 Copilot 使用议题表单,它会将提示中的信息分解到表单的相关字段中,而不会丢失任何数据。 如果 Copilot 存在信息不足而无法填写的字段,它会要求你提供更多上下文。

    根据你的提示,Copilot 还可以建议标签、被分配者和议题类型等元数据。

  5. 评审草稿。 您可以:

    • 手动编辑问题的任何部分。
    • 选择其他议题表单或模板,且不会丢失已输入的内容。 Copilot 将根据你选择的表单或模板重新设置内容格式。
    • 使用跟进提示要求 Copilot 进行更改。
  6. 问题看起来不错后,单击“Create”。****

一次性创建多个问题

如果你的提示包含多个任务或 bug,Copilot 可以一次性起草多个问题。

例如:在 OWNER/REPOSITORY 中,创建 3 个问题:1) 一个任务的详细信息,2) 另一个任务的详细信息,3) 第三个任务的详细信息

每个草稿单独显示,你可以单独评审和编辑它们。 若要发布问题,请在你想要提交的每个问题上单击“Create”。****

创建子议题

可使用 Copilot 来起草多个子议题。

例如:

In octo-org/octo-repo, plan a new user dashboard. Break it down into an epic, and create sub-issues for each main feature and task.

Copilot 将生成一个草稿议题树,其顶层为父议题,父议题下方包含多个子议题。

你可以查看议题树、展开或折叠子议题,并编辑每个议题的详细信息。

单击父议题可在工作台中查看其详细信息。 父议题会显示子议题列表,你可以单击任意子议题,以在工作台中查看和编辑其详细信息。 在子议题中,使用“Parent”下拉菜单可导航至议题树的不同层级。 也可单击工作台顶部的“Review and create”,以查看完整议题树并直接导航至任意议题****。

Copilot 可通过取消链接议题或附加新草稿的方式修改议题树。

例如,可以:

  • 从议题树中删除子议题:
    Remove sub-issue NAME_OF_ISSUE from the issue tree
  • 向议题树添加其他子议题:Add an additional sub-issue with ISSUE_DETAILS to the issue tree

完成草稿编辑并准备发布议题时,请单击“Review and create”,随后单击“Create issues”********。

使用现有议题

可使用 Copilot 将新议题与仓库中现有议题进行关联。

例如,可以:

  • 将子议题添加到现有父议题:
    Create a sub-issue for octo-org/octo-repo issue #456.
  • 将父议题添加到现有议题:Create a parent issue for octo-org/octo-repo issue #456.
  • 将父议题添加到多个现有议题:Create a parent issue for octo-org/octo-repo issues #456, #457, and #458.

草稿将显示在工作台中,你可在此处进行审阅和编辑。 要发布议题,请单击“Review and create”,然后单击“Create issues”********。

将问题分配给 Copilot

若要将问题分配给 Copilot,你想要启用 Copilot 编码智能体。 请参阅“关于适用于商业和企业的 GitHub Copilot 编码智能体”。

在创建过程中,可以通过下面两种方式之一分配问题:

  • 自然语言: 向 Copilot 提供以下类似提示:Assign this issue to Copilot.
  • 手动: 从被分配者列表中选择“Copilot”。

分配并创建问题后,Copilot 会自动开始处理问题。 你将在问题上看到 👀 表情符号,它指示 Copilot 正在处理问题。

其他阅读材料