{"meta":{"title":"使用GitHub Copilot减少技术债务","intro":"使用 Copilot 自动化重构和维护任务，从而解放团队，使他们能够专注于功能开发。","product":"GitHub Copilot","breadcrumbs":[{"href":"/zh/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/zh/enterprise-cloud@latest/copilot/tutorials","title":"教程"},{"href":"/zh/enterprise-cloud@latest/copilot/tutorials/reduce-technical-debt","title":"减少技术债务"}],"documentType":"article"},"body":"# 使用GitHub Copilot减少技术债务\n\n使用 Copilot 自动化重构和维护任务，从而解放团队，使他们能够专注于功能开发。\n\n## 介绍\n\n技术债务在每个代码库中累积：重复代码、缺少测试、过时依赖项和不一致的模式。 这些问题可能会累积，因为特征开发通常具有更高的优先级。 本教程介绍如何使用 GitHub Copilot 系统地处理技术债务，同时不牺牲功能开发速度。\n\n### 本教程面向谁\n\n本教程旨在帮助工程团队和技术主管减少技术债务，同时保持新功能交付速度。 你应该具备以下能力：\n\n* 可访问 Copilot 的 Copilot cloud agent 订阅\n* 至少一个存储库的管理员权限\n* 熟悉团队的开发工作流\n\n### 你要完成的操作\n\n在本教程结束时，你将了解以下内容：\n\n* 使用Copilot实现实时修复\n* 利用 Copilot cloud agent 执行大规模清理任务\n* 创建自定义说明以符合 Copilot 团队的标准\n* 衡量对技术债务的影响\n\n## 了解技术债务问题\n\n在开始减少代码库中的技术债务之前，你应该花些时间来确定团队最常面临的技术债务类型。\n\n常见的技术债务类型包括：\n\n* **代码重复** - 在多个位置实现的相同逻辑\n* **缺少测试** - 测试覆盖不足的特性\n* **过时的依赖项** - 库已落后于当前发布的几个版本\n* **不一致的模式** - 跨代码库对相同问题的不同方法\n* **旧代码** - 可以工作但不符合当前标准的旧代码\n\n技术债务的成本随着时间的推移而累积。\n\n* 高级工程师花时间进行例行更新，而不是体系结构设计\n* 代码评审因为审阅者对不一致模式的争论而变得更长\n* 由于代码组织混乱，新开发人员需要更长的时间加入\n* 部署风险随着过时依赖项累积漏洞而增加\n\n## 在您的 IDE 中使用 Copilot 进行即时修复\n\n避免代码库中积累的技术债务的最佳方式是首先防止它进入代码库。\n\n在开发过程中遇到技术债务时，请立即在 IDE 中使用 Copilot 进行修复。\n\n### 快速重构工作流\n\n1. 在 IDE 中工作时，突出显示需要改进的代码。\n\n2. 在 IDE 中打开 Copilot Chat 。\n\n3. 要求 Copilot 重构代码。 例如：\n\n * `Extract this into a reusable helper and add error handling`\n * `Standardize this logging format to match our pattern`\n * `Add null checks for all optional parameters`\n * `Replace this deprecated API call with the current version` \n\n4. 查看建议的更改。\n\n5. 接受更改或要求 Copilot 修改其方法。\n\n6. 运行测试以验证更改是否正常工作。\n\n### 示例：标准化错误处理\n\n如果您发现错误处理不一致，例如：\n\n```javascript id=\"err-handling\"\n// Highlight this code\ntry {\n await fetchData();\n} catch (e) {\n console.log(e);\n}\n```\n\n要求 Copilot 改进代码，例如：\n\n```copilot prompt copy ref=\"err-handling\"\nRefactor this to use structured logging and proper error handling\n```\n\nCopilot 可能建议：\n\n```javascript\ntry {\n await fetchData();\n} catch (error) {\n logger.error('Failed to fetch data', {\n error: error.message,\n stack: error.stack,\n timestamp: new Date().toISOString()\n });\n throw error;\n}\n```\n\n> \\[!NOTE] 此响应是一个示例。\n> Copilot Chat 响应是不确定的，因此，如果针对同一代码运行相同的提示，可能会获得不同的响应。\n\n通过采用立即修复方法，有助于确保不合格代码不会添加到代码库，并避免创建可能永远不会解决的积压工作问题。\n\n有关在 IDE 中使用Copilot的详细信息，请参阅[在 IDE 中向 GitHub Copilot 提问问题](/zh/enterprise-cloud@latest/copilot/how-tos/chat-with-copilot/chat-in-ide)。\n\n## 使用Copilot cloud agent进行大规模重构\n\n一些重构任务太大，无法完成，而团队中的每个人都忙于开发新功能。 在这种情况下，您可以使用 Copilot cloud agent 自主处理这些任务。 人工仍将是必要的——至少需要审查 Copilot cloud agent 所建议的更改——但通过让 Copilot 完成大部分工作，可以让你进行大规模重构, 从而对团队工作效率的影响要小得多。\n\n### 何时使用 Copilot cloud agent\n\n使用 Copilot cloud agent 执行以下任务：\n\n* 在代码库中修改多个文件\n* 需要系统更改（例如删除旧功能标志）\n* 需要仔细测试，但实现简单明了\n* 如果手动完成，将中断功能开发\n\n示例包括：\n\n* 影响 50 多个文件的框架升级\n* 删除已弃用的功能标志 \n* 迁移到严格的 TypeScript\n* 更新依赖项版本\n* 标准化导入模式\n\n### 工作流 Copilot cloud agent\n\n1. 创建一个描述重构任务的 GitHub 问题。\n\n 具体说明需要更改的内容。 例如：\n\n ```markdown\n Remove all feature flags marked for cleanup in Q2.\n\n These flags are:\n - `enable_new_dashboard`\n - `beta_export_feature`\n - `experimental_search`\n\n All three flags are enabled by default in production.\n\n Remove the flag checks and keep the \"enabled\" code path.\n ```\n\n2. 将问题分配给 **Copilot** 用户。\n\n3. Copilot cloud agent 将会有：\n\n * 设置开发环境\n * 打开草稿拉取请求\n * 对代码进行所需的更改\n * 运行测试\n * 完成提取请求以供审核\n * 请求你对拉取请求进行审核\n\n4. 审核拉取请求，就像审核由用户提出的拉取请求一样。\n\n5. 如果需要更改，请留下评论，Copilot cloud agent 将根据你的反馈更新拉取请求。\n\n6. 以这种方式循环，直到工作完成正确为止。\n\n7. 批准和合并拉取请求。\n\n有关详细信息，请参阅 [启动GitHub Copilot会话](/zh/enterprise-cloud@latest/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions) 和 [查看来自 Copilot 的输出](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/use-copilot-agents/review-copilot-output)。\n\n### 安全护栏\n\nCopilot cloud agent 使用内置安全措施进行操作：\n\n* 它只能推送到自己的 `copilot/*` 分支\n* 它无法合并拉取请求——需要您的审批\n* 所有的提交都被记录且可进行审计\n* 现有的分支保护仍处于活动状态\n* 在合并任何代码之前运行 CI/CD 检查\n\n## 为团队创建自定义说明\n\n自定义说明有助于 Copilot 了解团队的编码标准和模式。 这可确保建议从一开始就符合预期。\n\n### 设置自定义指令\n\n1. 在存储库中创建名为 `.github/copilot-instructions.md` 的文件。\n2. 以清晰、直接的语句添加团队的编码标准，例如使用项目符号列表。\n3. 将文件提交到存储库。\n\n### 自定义说明示例\n\n下面是有效的自定义指令示例：\n\n```markdown\n## Our Standards\n\n- Use structured logging, not console.log\n- Sanitize user input before database queries\n- Check for null/undefined on all optional parameters\n- Keep functions under 50 lines (extract helpers if needed)\n- Every public function needs a test\n- Flag any loops that might trigger N+1 queries\n\n## Error Handling\n\n- Always use try-catch blocks for async operations\n- Log errors with context (user ID, request ID, timestamp)\n- Never swallow errors silently\n- Return appropriate HTTP status codes\n\n## Testing Requirements\n\n- Unit tests for all business logic\n- Integration tests for API endpoints\n- Mock external services in tests\n- Test both success and failure paths\n```\n\n有关编写自定义说明的详细指南，请参阅 [为GitHub Copilot添加存储库自定义说明](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions)。\n\n### 自定义说明的优点\n\n自定义指令已设置后：\n\n* Copilot 建议编写符合您模式的代码\n* 代码评审变得更快，关于样式更改的讨论较少\n* 新团队成员通过Copilot的建议了解你的标准\n* 提高代码库的一致性\n\n## 运行试点计划\n\n在广泛应用之前，请从小范围开始，以验证 Copilot 对技术债务的影响。\n\n### 第 1 周：设置和建立基线\n\n1. 确保所有试点参与者具有 Copilot 访问权限，并启用了 Copilot cloud agent 。\n\n2. 统计积压事项中的技术债务项：\n\n * “技术债务”、“任务”或类似标签问题的数量\n * 过时依赖项数\n * 未通过 linter 检查的文件数量\n\n3. 跟踪当前指标：\n\n * 从创建拉取请求到合并重构 PR 的平均时间\n * 每个重构 PR 的平均审核轮次数\n\n4. 将 3-5 个最重要的标准创建到你的第一个 `.github/copilot-instructions.md` 文件中。\n\n### 第 2-4 周：实施试点\n\n1. 为试点选择 5-10 个存储库。\n\n2. 选择要解决的 1-2 个特定问题。 例如：\n\n * 特定区域中的代码重复\n * 对频繁更改的文件缺少测试\n * 过时的依赖项\n\n3. 在 Copilot IDE 中使用，以便在遇到问题时快速修复。\n\n4. 将更大的清理任务分配给Copilot cloud agent。\n\n5. 请仔细查看所有 Copilot 生成的 PR。\n\n6. 提供有关建议的反馈，以帮助 Copilot 了解你的偏好。\n\n### 第 5 周：评估结果\n\n试点后，测量结果：\n\n* 重构拉取请求合并的速度有多快？\n* 他们现在需要多少轮审查？\n* 开发人员最常接受哪种类型的代码更改建议（在 Copilot cloud agent 拉取请求中提出）\n* 哪些建议需要最修订？\n* 你的技术债务指标是否正在改进？\n\n * Linter 警告的数量在减少吗？\n * 测试覆盖率增加？\n * 依赖项版本更最新？\n\n根据你所了解到的哪些指导对 Copilot 帮助最大，更新自定义说明。\n\n## 衡量成功率\n\n跟踪特定指标，以了解 Copilot对技术债务的影响。\n\n### 速度指标\n\n监控Copilot对开发速度的影响。\n\n* 关闭技术债务问题的时间（目标：30-50% 减少）\n* 每周合并的技术债务拉取请求数量（目标：增加 2-3 倍）\n* 每个重构 Pull Request 的平均评审轮数（评估此轮数是增加还是减少）\n\n### 质量指标\n\n确保质量随速度一起提高：\n\n* Linter 警告计数（应该呈下降趋势）\n* 测试覆盖率百分比（这应呈上升趋势）\n* 与重构代码相关的生产事故数量（评估是否有变化）\n\n### 工程师满意度\n\n定期获取团队反馈：\n\n* 工程师们在例行维护上花费的时间是否更少？\n* 代码评审是否更注重体系结构，不关注样式？\n* 新团队成员的加入速度是否更快？\n\n## Troubleshooting\n\n### Copilot 显示不正确的更改\n\n如果 Copilot 一致地建议与需求不匹配的代码：\n\n* 查看自定义说明 - 它们可能过于模糊或矛盾\n* 在提示中提供更具体的上下文\n* 向自定义说明添加良好代码的示例\n* 在拉取请求评审中留下详细的反馈，使得 Copilot cloud agent 能够解决问题\n\n### 拉取请求太大，无法审查\n\n如果 Copilot cloud agent 创建难以审核的拉取请求：\n\n* 将大型任务分解为较小的重点问题\n* 要求 Copilot cloud agent 一次处理一个文件或目录\n* 使用更具体的问题说明\n\n### 更改导致测试失败\n\n如果重构引入了测试失败：\n\n* 在使用之前，请确保测试套件可靠运行 Copilot cloud agent\n* 在合并之前务必仔细查看 Copilot 的更改\n* 要求 Copilot 随代码更改一起更新测试\n\n### 团队采用速度缓慢\n\n如果你的团队没有使用 Copilot 来处理技术债务：\n\n* 分享早期采用者的成功案例\n* 演示团队会议中的节省时间\n* 从最恼火的技术债务项目开始\n* 将制定自定义说明作为团队活动\n\n## 结论\n\n在本教程中，你学习了如何使用 Copilot 系统地减少技术债务。 现在，你已了解如何：\n\n* 在 IDE 中使用 Copilot 立即修复技术债务\n* 将大型重构任务分配给 Copilot cloud agent\n* 创建自定义说明，以符合 Copilot 团队的标准\n* 运行试点计划以验证方法\n* 评估 Copilot 对技术债务的影响\n\n通过自动执行例行重构和维护任务， Copilot 可以让你专注于体系结构、功能开发和其他高价值工作。\n\n### 快速调查\n\n
\n\n阅读本教程后，您是否有信心使用 Copilot 来减少代码库中的技术债务？\n\n\nYesNo\n\n
\n\n## 后续步骤\n\n* **展开试点**：根据试点结果推广到更多存储库。\n* **自动执行依赖项更新**：创建定期问题来处理 Copilot cloud agent 依赖项更新。\n* **生成重构队列**：将积压工作中的问题标记为 Copilot 良好，然后定期将这些问题分配给 Copilot 进行处理。\n* **共享最佳做法**：记录团队的成功提示和自定义说明。\n\n## 延伸阅读\n\n* [GitHub Copilot云代理](/zh/enterprise-cloud@latest/copilot/how-tos/use-copilot-agents/cloud-agent)\n\n* [使用 GitHub Copilot 重构代码](/zh/enterprise-cloud@latest/copilot/tutorials/refactor-code)\n\n* [\n ](https://github.blog/developer-skills/github/how-to-use-github-copilot-in-your-ide-tips-tricks-and-best-practices/)\n\n* Copilot cloud agent"}