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 编码智能体。 请参阅“Managing access to GitHub Copilot coding agent”。

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

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

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

其他阅读材料