Repository navigation
BugfixAgent
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 业务代码来适配平台更新。
Copyright ©Mengning Software 2024-2026 All rights reserved.