AgentHarness 课程
Hermes 专题/课程概述

第四十五课:实战:Bug 修复工作流

问题定位代码审查修复验证

学习目标

  • 掌握使用 Codex 修复 Bug 的完整流程
  • 学会问题定位和修复验证
  • 了解 Bug 修复最佳实践

一、问题描述

1.1 清晰描述

提供清晰的 Bug 描述:

  • 现象:发生了什么
  • 预期:应该发生什么
  • 复现:如何复现
  • 环境:操作系统、Node.js 版本等

1.2 示例

codex "用户登录时出现 500 错误,预期应该返回 200。复现步骤:1. 打开登录页面 2. 输入用户名密码 3. 点击登录"

二、问题定位

2.1 代理分析

代理会:

  1. 阅读相关代码
  2. 分析错误日志
  3. 定位问题根因
  4. 提出修复方案

2.2 常见问题类型

  • 语法错误
  • 逻辑错误
  • 类型错误
  • 空指针
  • 并发问题

三、修复方案

3.1 方案评估

代理提出修复方案后,评估:

  • 是否解决了根本问题
  • 是否会引入新问题
  • 是否符合代码规范

3.2 执行修复

批准后,代理执行修复:

  1. 修改代码
  2. 运行测试
  3. 验证修复

四、修复验证

4.1 运行测试

npm test

4.2 手动验证

按照复现步骤验证是否修复。

4.3 回归测试

确保修复没有引入新问题。

五、最佳实践

5.1 问题描述

  • 提供详细的复现步骤
  • 包含错误信息和日志
  • 说明环境信息

5.2 修复过程

  • 先理解问题再修复
  • 编写测试用例
  • 验证修复效果

5.3 预防措施

  • 添加错误处理
  • 编写边界测试
  • 代码审查

六、本课小结

要点说明
问题描述清晰描述现象、预期、复现
问题定位代理分析代码和日志
修复验证运行测试 + 手动验证
最佳实践详细描述、理解问题、编写测试

下一步

下一课我们将学习代码重构。