在 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 开发者版应用程序会尝试在您授权访问的 GitHub 存储库中，自动创建 Amazon Q 开发代理和 Amazon Q 转换代理标签。若这些标签未自动创建或被意外删除，您可在 GitHub 中手动创建。这两个标签的名称必须为 Amazon Q 开发代理和 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 generating the proposed code changes and opened a pull request: Resolve Create an image recognition app”），然后点击拉取请求链接。

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

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

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

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

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

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

  2. 找到您希望留下反馈并让 Amazon Q 开发者版迭代优化的代码行，选择+号添加含反馈的评论，然后选择开始审查。

    提交审查后，Amazon Q 开发者版会基于您的反馈开始审查代码。完成反馈修订后，Amazon Q 开发者版会将变更提交到拉取请求，并通过评论告知您更新情况。

  3. 选择完成审查，选中请求变更单选按钮，然后选择提交审查，让您的反馈得到处理。

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

Amazon Q 开发者版与 GitHub Actions 工作流集成，可构建智能反馈循环系统。拉取请求创建后，已配置的工作流（如单元测试）会自动执行。若工作流执行失败，Amazon Q 开发者版会分析输出结果，并根据结果和失败信息对代码更改进行迭代优化。随着代码更改的推送和工作流的执行，Amazon Q 开发者版会解读结果，并利用这些信息改进其处理方式。由此形成持续学习循环，每次迭代都基于之前的尝试，Amazon Q 开发者版能够不断优化解决方案。

反馈循环的有效性取决于是否有定义清晰的测试和工作流，为 Amazon Q 开发者版提供可解读、可执行的有效反馈。您可通过存储库中的 GitHub Actions YAML 文件配置工作流，实现自定义测试和验证流程，让 Amazon Q 开发者版能够对此做出响应。有关更多信息，请参阅《GitHub 文档》中的了解 GitHub Actions。