在 GitHub 中使用 Amazon Q 开发者版开发功能并迭代 - Amazon Q 开发者版

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在 GitHub 中使用 Amazon Q 开发者版开发功能并迭代

注意

GitHub 版 Amazon Q 开发者版目前处于预览发布阶段，功能可能会发生变更。

在 GitHub 中，您可以使用 Amazon Q 开发者版自动实现新功能和漏洞修复，将任务从想法转化为完整的拉取请求，从而简化开发流程。当您为问题添加“功能开发”标签，或使用 /q dev 斜杠命令时，Amazon Q 开发者版会将该问题（包括标题、描述）及存储库代码作为上下文，生成新的代码修复方案并创建拉取请求。在拉取请求中，您可以提供反馈，Amazon Q 开发者版会基于反馈对建议代码进行迭代优化。

您每月可使用 Amazon Q 开发者版执行有限次数的功能开发。您可以随时通过使用您的AWS账户注册安装的 Amazon Q Developer 应用程序来增加免费使用量。有关更多信息，请参阅 在 Amazon Q 开发者版控制台中提高使用限额并配置的详细信息。

重要

Amazon Q Developer 应用程序会尝试在您授权访问的GitHub存储库中自动创建 Amazon Q 开发代理标签。如果标签不是自动创建的，或者是无意中删除的，则可以在中手动创建GitHub。必须将该标签命名为 Amazon Q 开发代理，才能将其识别为 Amazon Q 开发者标签并进行处理。有关更多信息，请参阅《GitHub 文档》中的创建标签。

要使用 Amazon Q 开发者版进行功能开发，请执行以下步骤

  1. 如有需要，可使用您的 GitHub 凭证登录 GitHub 账户。

  2. 导航至您的 GitHub 组织，然后进入您希望使用 Amazon Q 开发者版开发新功能的存储库。

  3. 选择问题，然后创建新问题或选择现有问题。有关更多信息，请参阅《GitHub 文档》中的创建问题。

    1. 对于新问题，在添加标题文本输入框中，输入能为 Amazon Q 开发者版提供功能开发上下文的标题（例如：“创建图像识别应用程序”）。同时需包含问题描述，因其也会为功能开发提供上下文。

      对于现有问题，您可以编辑问题标题和描述，为 Amazon Q 开发者版提供功能开发所需的上下文。有关更多信息，请参阅《GitHub 文档》中的编辑问题。

  4. 创建问题或配置现有问题时，可添加 Amazon Q 开发者版“功能开发”标签，或使用 /q dev 斜杠命令。请执行以下操作之一：

    • 要为问题添加标签，请执行以下操作之一：

      • 选择作为浏览器扩展程序提供的分配给 Amazon Q 下拉菜单，然后选择 Amazon Q 开发代理标签。

      • 在右侧菜单中选择标签，然后选择 Amazon Q 开发代理标签。

    • 要在评论中使用 /q dev 斜杠命令，请执行以下操作：

      1. 在“问题”页面中，导航至添加评论区域，在评论文本输入字段中输入 /q dev。

      2. 选择评论。

  5. 对于新问题，选择创建问题，完成包含 Amazon Q 开发者版开发功能所需详情的问题创建。如果您配置的是现有问题，请确保保存更改。有关更多信息，请参阅《GitHub 文档》中的编辑问题。

    当 Amazon Q 开发者版完成功能开发的代码更改生成后，会在问题中添加评论并创建拉取请求。

  6. 导航至 Amazon Q 开发者版留下的评论（例如：“I finished the proposed code changes, and the pull request is ready for review: [PR link]”），然后点击拉取请求链接。

    您也可以导航至拉取请求选项卡，然后选择 Amazon Q 开发者版创建的拉取请求。

  7. 选择文件变更选项卡，查看代码更改。

  8. 如果您对建议的代码更改感到满意，可合并该拉取请求。有关更多信息，请参阅合并拉取请求。

您也可以审查该功能开发的拉取请求，并通过向 Amazon Q 开发者版提供反馈，对建议的代码更改进行迭代优化。

要对 Amazon Q 开发者版功能开发代码进行迭代，请执行以下步骤

  1. 选择 Amazon Q 开发者版创建的拉取请求，然后选择文件变更选项卡，查看代码更改。

  2. 或者，对于要提供反馈的特定代码行，请选择 + 以添加带有反馈的评论。

    在对话中，您可以使用/q命令，然后使用自然语言进行指示（例如，/q implement my suggestions或/q refactor this function for better performance）。Amazon Q Developer 将在回复时附上一条评论，描述它将根据您的反馈做出的更改（例如，“我将根据反馈实施以下更改：...”）。实施完成后，Amazon Q Developer 将发布另一条评论来确认更改（例如，“我已实施了建议的更改。”），并附上指向生成的提交链接，您可以在其中查看更改。

  3. 点击对话中提供的提交链接，查看 Amazon Q 开发者所做的更改。您可以根据需要使用/q命令继续提供其他反馈以进行进一步的迭代。

  4. 如果您对更新后的代码更改满意，可合并拉取请求，或通过新反馈再次对代码进行迭代。有关更多信息，请参阅合并拉取请求。