使用GitHub Copilot减少技术债务

在 IDE 中工作时，突出显示需要改进的代码。
在 IDE 中打开 Copilot Chat 。
要求 Copilot 重构代码。例如：
- Extract this into a reusable helper and add error handling
- Standardize this logging format to match our pattern
- Add null checks for all optional parameters
- Replace this deprecated API call with the current version
查看建议的更改。
接受更改或要求 Copilot 修改其方法。
运行测试以验证更改是否正常工作。

示例：标准化错误处理

如果您发现错误处理不一致，例如：

// Highlight this code
try {
  await fetchData();
} catch (e) {
  console.log(e);
}

要求 Copilot 改进代码，例如：

Copilot prompt

Refactor this to use structured logging and proper error handling

// Highlight this code
try {
  await fetchData();
} catch (e) {
  console.log(e);
}

Refactor this to use structured logging and proper error handling

Refactor this to use structured logging and proper error handling

Copilot 可能建议：

try {
  await fetchData();
} catch (error) {
  logger.error('Failed to fetch data', {
    error: error.message,
    stack: error.stack,
    timestamp: new Date().toISOString()
  });
  throw error;
}

注意

此响应是一个示例。 Copilot Chat 响应是不确定的，因此，如果针对同一代码运行相同的提示，可能会获得不同的响应。

通过采用立即修复方法，有助于确保不合格代码不会添加到代码库，并避免创建可能永远不会解决的积压工作问题。

有关在 IDE 中使用Copilot的详细信息，请参阅在 IDE 中向 GitHub Copilot 提问问题。

使用Copilot cloud agent进行大规模重构

一些重构任务太大，无法完成，而团队中的每个人都忙于开发新功能。在这种情况下，您可以使用 Copilot cloud agent 自主处理这些任务。人工仍将是必要的——至少需要审查 Copilot cloud agent 所建议的更改——但通过让 Copilot 完成大部分工作，可以让你进行大规模重构, 从而对团队工作效率的影响要小得多。

何时使用 Copilot cloud agent

使用 Copilot cloud agent 执行以下任务：

在代码库中修改多个文件
需要系统更改（例如删除旧功能标志）
需要仔细测试，但实现简单明了
如果手动完成，将中断功能开发

示例包括：

影响 50 多个文件的框架升级
删除已弃用的功能标志
迁移到严格的 TypeScript
更新依赖项版本
标准化导入模式

工作流 Copilot cloud agent

创建一个描述重构任务的 GitHub 问题。

具体说明需要更改的内容。例如：

Remove all feature flags marked for cleanup in Q2.

These flags are:
- `enable_new_dashboard`
- `beta_export_feature`
- `experimental_search`

All three flags are enabled by default in production.

Remove the flag checks and keep the "enabled" code path.

将问题分配给 Copilot 用户。
Copilot cloud agent 将会有：
- 设置开发环境
- 打开草稿拉取请求
- 对代码进行所需的更改
- 运行测试
- 完成提取请求以供审核
- 请求你对拉取请求进行审核
审核拉取请求，就像审核由用户提出的拉取请求一样。
如果需要更改，请留下评论，Copilot cloud agent 将根据你的反馈更新拉取请求。
以这种方式循环，直到工作完成正确为止。
批准和合并拉取请求。

有关详细信息，请参阅启动GitHub Copilot会话和查看来自 Copilot 的输出。

安全护栏

Copilot cloud agent 使用内置安全措施进行操作：

它只能推送到自己的 copilot/* 分支
它无法合并拉取请求——需要您的审批
所有的提交都被记录且可进行审计
现有的分支保护仍处于活动状态
在合并任何代码之前运行 CI/CD 检查

为团队创建自定义说明

自定义说明有助于 Copilot 了解团队的编码标准和模式。这可确保建议从一开始就符合预期。

设置自定义指令

在存储库中创建名为 .github/copilot-instructions.md 的文件。
以清晰、直接的语句添加团队的编码标准，例如使用项目符号列表。
将文件提交到存储库。

自定义说明示例

下面是有效的自定义指令示例：

## Our Standards

- Use structured logging, not console.log
- Sanitize user input before database queries
- Check for null/undefined on all optional parameters
- Keep functions under 50 lines (extract helpers if needed)
- Every public function needs a test
- Flag any loops that might trigger N+1 queries

## Error Handling

- Always use try-catch blocks for async operations
- Log errors with context (user ID, request ID, timestamp)
- Never swallow errors silently
- Return appropriate HTTP status codes

## Testing Requirements

- Unit tests for all business logic
- Integration tests for API endpoints
- Mock external services in tests
- Test both success and failure paths