Skip to main content
Skip to content

GitHub.com 上使用 GitHub Copilot 的快速入门

无需离开 GitHub,只需向 Copilot in the cloud 提问并将编码任务交给它,即可更快地理解代码并完成工作。

谁可以使用此功能?

Copilot in the cloud 默认为所有付费 Copilot 计划启用。

代理在所有存储于GitHub的存储库中可用,除非这些存储库由托管用户帐户拥有或已被显式禁用。
Sign up for Copilot

GitHub Copilot 内置在 GitHub 中,因此无需安装任何内容即可使用。

本快速入门大约需要 15 分钟,并演示如何询问有关存储库的问题、请求和查看代码更改,以及如何使用 GitHub Mobile 继续处理 Copilot。

Prerequisites

  • 对于任务 1,需要对存储库(例如公共 github/docs 存储库)具有读取访问权限。
  • 对于任务 2 和 3,需要对存储库具有写入访问权限。 建议使用你拥有或有权限对其进行更改的存储库。
  • 若要完成本快速入门中的每个任务,Copilot 必须对你的帐户可用,并已针对你将使用的存储库启用。 有关设置指南,请参阅 启用 Copilot。
  • 若要执行任务 3,需要为您的帐户安装并设置 GitHub Mobile。 请参阅“GitHub移动版”。

任务 1:询问 Copilot 有关存储库的问题

  1. 从 主页与Copilot。

  2. 在提示框下方,打开 聊天 会话范围选取器。

  3. 在 在存储库中工作下,搜索并选择要浏览的存储库。

    • 如果需要尝试仓库,请使用公共 github/docs 仓库。
  4. 如果某个特定文件、问题或拉取请求与之相关,请在提示框中键入 @ 并从建议中选择它。 这提供了 Copilot 一个特定位置来查找上下文。

  5. 询问有关存储库的问题。 例如:

    Copilot prompt
    I'm new to github/docs. How is this repository organized,
    and where should I start to understand how the site is built?
    
    Copilot prompt
    In /package.json, which scripts look relevant for validating
    a change, and what command does each run?
    
    Copilot prompt
    What behavior does
    /src/color-schemes/tests/color-mode-script.ts cover?
    Suggest one additional test case that would fit the
    existing tests, and explain why.
    

    若要从上述示例创建提示,请选择 复制,并将其粘贴到提示框中。 然后按 Enter 发送提示词。

Copilot 的答案显示在对话中。 询问有关文件、功能或错误的具体问题,以获得更有用的答案。

  1. 在同一提示框中键入问题并按 Enter,询问后续问题。 对话为你的下一个问题提供了 Copilot 上下文。

任务 2:请求并查看代码更改

  1. Copilot

  2. 在具有写入访问权限的存储库中,使用 Chat 会话范围选取器,并选择 在存储库中工作 下的存储库。

  3. 申请更改代码。 声明所需的结果以及任何相关的文件或行为。 例如,复制并发送以下提示:

    Copilot prompt
    Add a small ASCII art image to the top of the README file.
    

    将提示粘贴到提示框中,然后按 Enter 将其发送。 Copilot 在后台处理该任务。

    重要

    在允许更改之前,请查看所有Copilot权限请求或操作请求。

  4. 当 Copilot 处理该请求时,您可以继续与会话交互。 还可以展开 Copilot 在会话日志中执行的每个步骤,以查看已执行的工作和使用的工具。

  5. Copilot 完成后,它将在提示框上方显示更改,并显示用于创建拉取请求的选项。

  6. 单击 “更改” 以查看建议的更改。

  7. 若要进行进一步更改,请在同一提示框中键入后续请求,然后按 Enter。 会话会保留前面提示中的上下文。

  8. 单击 “创建拉取请求”,然后单击 “查看 PR” 链接以查看更改。

前往任务 3 以继续在 GitHub Mobile 中进行会话。

任务 3:在 GitHub Mobile 中继续会话

  1. 在设备上打开 GitHub Mobile 。

  2. 在主页中,点击 屏幕右下角的图标。

  3. 在最近会话列表中,点击上面创建的会话的名称。 该名称通常基于你发送的第一个提示。 在此示例中,它可能类似于 README ascii art.

  4. 单击 “查看 PR”,然后单击 “文件已更改”,再次查看建议的更改。

  5. (可选)若要请求其他更改,请单击受影响的行。 添加一个注释,提及 @copilot 并描述要更改的内容。 然后选择“评论”,然后单击“完成审阅”,以便 Copilot 查看并处理你的请求。

Copilot 将对你的评论作出回应,并在可能的情况下启动会话以进行所请求的更改。 拉取请求页面上的时间线事件将在 Copilot 完成时显示,并且 Copilot 会再次请求你审阅,并附上结果回复你之前的评论。

  1. 当你对拉取请求感到满意时,必须 标记为已准备好进行评审。

  2. 查看所做的更改 Copilot ,确保它们符合预期。 如果需要,请单击批准,然后单击完成评审,使 PR 处于可合并状态。

  3. 单击“ 合并 ”以合并拉取请求。

    接下来,让我们查看更新的自述文件。

  4. 返回到GitHub Mobile上的主页以搜索存储库,然后打开它。

  5. 滚动到页面底部以查看存储库的自述文件,并欣赏你的艺术品!

后续步骤