示例:修复 Bug
本示例展示如何用 ByteMind 诊断并修复一个失败的测试或报告的 Bug,突出最小化变更范围。
场景
集成测试失败:登录接口对有效凭证返回 500 Internal Server Error。你希望定位根因并在不影响其他代码的前提下实施修复。
第一步:使用 Bug 排查技能
激活结构化的 Bug 排查工作流:
text
/bug-investigation symptom="登录接口对有效凭证在集成测试中返回 500"技能引导 Agent:
- 定位相关处理器和中间件
- 追踪请求到错误的调用链
- 读取日志或测试输出求证
- 形成带置信度的根因假设
第二步:先读后写
请 Agent 先分析,不做任何修改:
text
读取登录处理器和认证中间件。识别对有效凭证返回 500 的可能原因。不要修改任何内容。审阅 Agent 的分析结果,确认根因后再继续。
第三步:应用最小修复
text
对已确认的根因应用修复。变更尽可能小。不要修改无关代码和测试。每次写入操作时审批确认。
第四步:补充回归测试
text
添加一个能够覆盖此 Bug 的单元测试。测试应针对触发 500 的具体条件。第五步:验证修复
text
运行受影响的测试确认修复有效。Agent 会调用 run_shell 执行测试命令——审批确认即可。
一次性提示词写法
对于已清楚了解的 Bug,可合并为单个提示词:
text
定位登录接口在集成测试中对有效凭证返回 500 的原因。
应用最小修复并补充回归测试。
不要修改认证模块以外的任何代码。期望产出
- 带证据的清晰根因分析
- 变更限制在最小必要的修改范围
- 覆盖确切失败路径的新回归测试
- 现有所有测试仍通过