# External Gitcode Ascend Auto Bug Fixer

> Use when encountering bugs, test failures, or error logs that need root cause analysis and fix generation

- Skill: `ascend-ai-coding/external-gitcode-ascend-auto-bug-fixer` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ascend-ai-coding/external-gitcode-ascend-auto-bug-fixer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ascend-ai-coding/external-gitcode-ascend-auto-bug-fixer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: UNKNOWN
- Author: ascend-ai-coding (https://skillmd.com/u/ascend-ai-coding)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ascend-ai-coding/external-gitcode-ascend-auto-bug-fixer

---


# Bug 定位与修复技能

## 概述
通过结构化的错误分析和根因定位流程，自动生成最小化diff格式修复补丁和防回归测试用例，实现从错误现象到完整修复方案的端到端自动化处理。

## 使用场景
- 遇到程序崩溃、异常抛出、测试失败等错误现象需要分析
- 需要定位bug的根本原因（特别是代码变更引入的问题）
- 需要生成符合工程化规范的代码修复补丁
- 需要创建可执行的防回归测试用例
- 需要完整的bug分析报告（包含根因、修复、测试、预防建议）

## 快速参考
| 场景 | 定位方法 | 适用条件 |
|------|----------|----------|
| 通用bug分析 | 自顶向下追踪法 | 无明确代码变更/PR信息 |
| 代码变更引入bug | Git二分法 | 有code_change_info，需定位具体PR/提交 |

| 错误码 | 含义 | 处理方式 |
|--------|------|----------|
| E001 | 输入信息缺失或无法解析 | 补充必填输入（error_phenomenon/reproduce_steps） |
| E002 | 根因模糊无法准确定位 | 提供更多上下文信息或代码变更信息 |
| E003 | 补丁生成失败 | 确认根因已锁定，检查代码上下文 |
| E004 | 测试用例生成失败 | 确认修复补丁有效，指定测试框架 |

## 核心能力（动作+结果，无重叠/无超范围）
1. 解析多语言错误现象，校验必填输入信息的完整性和有效性
2. 对通用场景采用**自顶向下追踪法**、对代码变更/PR场景采用**Git二分法**定位bug根因，并验证根因的可复现性
3. 针对根因生成最小化diff格式代码修复补丁，校验补丁语法正确性，遵循工程化开发规范
4. 为主流测试框架创建可直接执行的防回归测试用例，覆盖正常/边界/异常核心场景
5. 输出结构化Markdown格式的Bug分析报告，包含错误现象描述、复现步骤、根因分析、修复补丁、测试用例和预防建议

## 工作流程（步骤+校验+中断+反馈，Agent可直接执行）
### 第一步：信息收集与校验
✅ **校验点**：检查必填输入（error_phenomenon/reproduce_steps）是否完整、可识别
❌ **中断条件**：缺失必填输入 / 错误现象无法解析（如乱码、不完整）→ 抛出错误码**E001**并中断
📝 **反馈**：输出「信息收集完成，可进入根因分析阶段 / 缺失必填输入，错误码E001」

### 第二步：根因分析与确认
✅ **校验点**：根因可复现，且精准锁定至具体**代码行/文件/PR/提交记录**
❌ **中断条件**：信息不足导致根因模糊，无法准确定位 → 抛出错误码**E002**并中断
📝 **反馈**：输出「根因已定位：XXX（关联PR/提交：XXX） / 根因模糊，错误码E002」

#### 定位方法（Agent根据输入自动选择，强化Git二分法定位PR/提交）
##### 方法一：自顶向下追踪法（通用场景，无明确代码变更/PR信息）
1. 分析错误堆栈跟踪，定位抛出异常/触发错误的具体代码行/文件
2. 检查该位置的入参、数据流、依赖调用是否符合业务预期
3. 若输入/依赖存在异常，逐级向上游追踪数据来源/调用方
4. 重复上述步骤，直至找到根因（数据/逻辑首次出现异常的位置）

##### 方法二：Git二分法定位（代码变更/PR引入bug场景，核心定位问题PR/提交）
1. 根据输入的code_change_info，确认**bug未出现的最后正常版本/PR/提交**、**bug首次出现的异常版本/PR/提交**
2. 依次执行Git二分法命令：`git bisect start` → `git bisect bad [异常版本/提交哈希]` → `git bisect good [正常版本/提交哈希]`
3. Git自动缩小排查范围，定位到**引入bug的具体提交记录/关联PR**（二分法结果中唯一的变更记录）
4. 分析目标提交/PR的代码变更内容，锁定根因代码行，并做验证：回滚该提交/PR后，确认bug是否消失
5. 若涉及多个PR/提交，按影响程度排序，提供逐一验证的方法

### 第三步：最小化Diff格式补丁生成与校验
✅ **校验点**：补丁为标准diff格式、修改粒度最小、语法无错误、仅针对根因修复
❌ **中断条件**：根因未锁定 / 无有效代码上下文 → 抛出错误码**E003**并中断
📝 **反馈**：输出「Diff格式修复补丁已生成，共X处修改 / 补丁生成失败，错误码E003」

#### 补丁生成原则（强制遵循）
- 最小化修改：仅修改与根因相关的代码，无无关逻辑/格式变更
- 根因修复：解决问题本质，而非临时规避表象问题
- 防御性编程：必要时添加输入校验、边界判断、异常捕获逻辑
- 工程化规范：符合项目编码规范，不引入新的语法/逻辑问题
- 可追溯性：关键修复点添加单行注释，说明修复原因和关联根因

### 第四步：防回归测试用例生成与校验
✅ **校验点**：测试用例可直接执行、覆盖根因相关核心场景、匹配项目实际使用的测试框架
❌ **中断条件**：无有效修复补丁 / 未指定测试框架 → 抛出错误码**E004**并中断
📝 **反馈**：输出「防回归测试用例已生成，共X个（适配XXX框架） / 测试用例生成失败，错误码E004」

#### 测试用例核心要求
- 可复现：能精准复现原始bug（修复前执行失败）
- 可验证：修复后执行通过，能有效验证补丁的修复效果
- 全覆盖：覆盖根因相关的正常场景、边界场景、异常场景
- 可执行：无语法错误，适配主流测试框架（gtest/pytest/JUnit/GoTest/Jest/Vue Test Utils）

## 输出格式（结构化Markdown，机器+人类双友好，固定模板不可随意修改）

## Bug 分析报告
### 一、错误现象
1. 错误描述：[清晰描述错误类型、报错信息、影响范围、关联业务场景]
2. 复现步骤：[步骤化复现方法，包含运行环境、测试数据、操作步骤、关联版本]
3. 输入校验：[通过/失败，失败则标注错误码+具体原因]
4. 代码变更信息：[从输入中提取的PR/提交/分支信息，标注二分法定位关键信息]

### 二、根因分析
1. 根因定位：[具体根因，如除零错误/空指针异常/逻辑判断错误，关联PR/提交则标注哈希/编号]
2. 定位方法：[自顶向下追踪法 / Git二分法（关联PR：XXX，提交哈希：XXX）]
3. 追踪过程：[简要描述数据流/调用链/Git二分法的执行过程，标注锁定根因的关键步骤]
4. 影响范围：[受影响的代码模块/PR/分支/业务场景/用户群体]

### 三、最小化Diff格式修复补丁
[标准diff格式，包含文件路径、行号、修改内容，关键修复点添加注释说明]
```diff
diff --git a/.github/workflows/nightly_benchmarks.yaml b/.github/workflows/nightly_benchmarks.yaml
index 123456..789abc 100644
--- a/.github/workflows/nightly_benchmarks.yaml
+++ b/.github/workflows/nightly_benchmarks.yaml
@@ -15,6 +15,10 @@
     - name: Install dependencies
       run: |
         pip install -e .
+        # 安装msprobe相关依赖（修复根因：PR#4241引入的msprobe功能需要这些依赖）
+        pip install mindstudio-probe==8.3.0 || echo "msprobe installation skipped"
+        pip install tb_graph_ascend || echo "tb_graph_ascend installation skipped"
```

### 四、防回归测试用例
[可执行的测试代码，适配项目实际使用的测试框架，覆盖正常/边界/异常场景]
```python
# 示例：pytest框架测试用例
def test_bug_fix_reproduction():
    """复现原始bug（修复前执行失败）"""
    # 测试代码...
    assert result == expected

def test_bug_fix_validation():
    """验证修复效果（修复后执行通过）"""
    # 测试代码...
    assert fixed_result == expected

def test_edge_cases():
    """边界场景测试"""
    # 测试代码...
    pass
```

### 五、预防建议
1. 代码层面：[针对根因的代码改进建议，如添加参数校验、异常处理等]
2. 流程层面：[开发流程改进建议，如代码审查要点、测试覆盖要求等]
3. 工具层面：[工具或监控建议，如静态分析、日志增强等]