Skip to content

BugfixAgent

DevStar Bot edited this page Nov 18, 2026 · 3 revisions

Bugfix Agent

Bugfix Agent 根据可复现的缺陷定位原因、修改代码、运行验证并交付评审 PR。可以只诊断不修改;具体交付范围以你提出的目标和授权为准。

开始前

  • 业务项目仓库已有源码、提交和默认分支;提供可用的复现方法或测试命令。
  • 内置 AI 分析无需配置模型;外部 Agent 的模型要求以启动页检查为准,已有配置可复用,提示缺少时再按Agent Team 使用指南补充。
  • 按 Agent Team选择或添加 Bugfix Agent 模板,在业务项目启动实例。修复并创建 PR 需要相应代码和 PR 写权限,仅诊断则不应授予不必要的写权限。

已有项目可直接使用,不必为了体验 Agent 另建项目、复制玩具函数或手工修改代码制造缺陷。测试依赖和执行环境按项目及模板说明准备。

提交缺陷工单

在需要修复的业务项目中新建 Issue,不是在模板仓库创建。写清:

标题:失败场景中的实际问题
复现:输入、操作顺序,以及可重复触发问题的条件。
实际:目前发生了什么。
期望:应该发生什么,不应改变哪些既有行为。
验证:项目实际可运行的测试命令或具体复现步骤。
交付:请修复并提交评审 PR,说明根因与验证结果,不修改无关文件、不合并。

将上述占位内容替换为项目事实。比如报告“保存失败后输入丢失”,要同时给出可复现的失败条件、应保留的输入和验证方法;不要让 Agent 猜测业务决定或编造不存在的测试命令。

授权修复并检查结果

开启 AI Issues 和讨论规划后,新工单的分析评论会自动触发 Planner。核对建议的目标确实是修复而非只诊断,再授权执行。已有工单正常评论目标即可,不需要固定步骤或额外规划口令。

支持完整任务交接的 Runtime 可在本次授权范围内完成分析、修改、验证并创建 PR。旧版本或仅批准准备候选的任务,仍需在查看候选后确认发布;按页面实际说明操作,不扩大旧授权。只有诊断时可以只交付评论,没有 PR 是正常的。

也可直接使用实际实例支持的命令,例如 @bugfix-agent /fix 按本工单修复、验证并提交评审PR,不合并;仅诊断可用 /diagnose。无需同时点击建议和发送命令,避免重复任务。

打开真实 PR,而非只看“已完成”摘要:

  • 代码差异是否真正修复所报问题,修改范围是否受控。
  • 原本失败的复现或测试是否通过,已有测试是否回归。
  • 报告是否说明实际执行的命令、结果及未验证内容;环境失败不算测试通过。
  • PR 是否属于正确业务仓库,默认分支未变且未合并。

提交评审意见

在同一 PR 评论具体修订要求;Planner 可以提出继续修复的建议,核对后授权。Agent 应继续原 PR/分支,重新验证,不覆盖人工提交,也不为同一修订另开无关 PR。实际实例支持时也可使用 /fix-followup 明确指定目标。

已经执行的操作不能再次勾选;补充条件用新评论表达。失败先检查任务日志和已有提交,不因重复点击而产生第二次修改。

遇到问题

现象 处理方法
实例未注册或没有修复建议 按 Agent Team检查模型、连接、仓库范围、权限和讨论规划
只有分析,没有 PR 确认目标不是仅诊断,是否等待补充或发布授权,再看是否因环境、依赖或验证失败停止
找不到源码 确认 Issue 属于业务项目,不是 Agent 模板仓库;工作区取自任务所属项目
PR 已创建但不能判断修复正确 对照工单复现,并检查真实测试结果;创建 PR 本身不是修复正确的证明

模板代码、支持命令与项目运行要求见 Bugfix Agent 业务说明。普通用户无需修改 Agent 业务代码来适配平台更新。

Clone this wiki locally