BUG修复

技能文档

---
name: bugfix
description: 根据用户描述的问题现象，分析代码库定位 bug 根因，定位后无须用户确认直接自动修复代码，输出修复报告（含根因、修改内容、验证结果）。当用户要求修 bug、修复报错、直接修复问题、bugfix 时触发。
title: BUG修复
category: 开发工具
---

## 边界

定位根因后**无须用户确认，直接修改代码完成修复**。只修与根因直接相关的代码，修复动作之外的边界与诊断类技能一致：不顺手重构、不改无关代码。

## 技能工作流

### 信息收集与追问

从用户描述中提取：问题现象、错误证据（日志/截图/堆栈）、环境信息、影响范围。能通过代码库自行确认的信息不要问用户。信息不足时按复现步骤、影响范围、环境信息、错误证据四个维度一次问完，最多追问 2 轮；用户已提供堆栈或详细日志时跳过追问。

### 代码分析

分析前先确认本地代码是否最新：向用户展示当前分支、远程主分支及远程最新几条提交，经用户同意后再 fetch/pull 同步（本地有未提交改动先 stash）；用户拒绝时基于本地代码继续并在报告中注明，同步失败则提示用户检查网络和 Git 配置并中止分析。

定位策略：

- **有堆栈/类名/方法名**：直接定位源文件和行号。
- **仅有现象描述**：先语义/关键字搜索缩小范围，再读文件确认；模块边界以仓库实际结构为准。

如有数据库或日志访问能力，可查询运行时数据验证假设；没有则跳过，报告中标注「无运行时证据」。

### 自动修复

定位根因后**直接动手修复，不再向用户征求修复许可**，但遵守以下护栏：

- **最小改动**：只改与根因直接相关的代码，不重构、不优化、不改编码风格。
- **低置信度不修**：根因置信度为「低」时停止修复，只输出诊断结论并建议人工介入。
- **修复后必验证**：执行编译/语法检查；仓库有相关单测时运行对应测试。验证失败则回退本次修改，报告中说明失败原因。
- 分析中发现的其他 bug 只报告，不顺手修。

### 输出修复报告

每个 bug 固定模板，**上限 12 行，超出即违规**：

```
[BUG-N] 一句话标题 | 置信度：高/中/低 | 风险：高/中/低
根因：一句话
修改：文件:行号 → 改了什么（多处每处一行）
验证：编译/测试结果
遗留：一句话说明未覆盖的场景，无则写「无」
```

## 输出规范

- 使用中文输出，不输出完整分析过程、排查路径和大段代码片段。
- 置信度：高=有日志/堆栈佐证，中=代码推断，低=推测。
- 风险由影响面和触发几率综合判断：高=核心链路、影响面广或触发几率高，中=部分影响或需特定条件触发，低=边缘场景、影响小且触发几率低。
- 禁止编造文件路径或行号；无证据时禁止标注「高」置信度。
- 修复只解决已确认的根因，不引入新的行为变更。

使用说明

# BUG修复（bugfix）

根据你描述的问题现象，自动分析代码库定位 bug 根因，**定位后无须确认直接修复**，并输出一份修复报告。

## 什么时候用

- 页面卡住、超时报错、数据对不上等功能缺陷，想直接修掉
- 有错误日志或堆栈，希望定位后一步到位修复
- 性能瓶颈定位清楚后，直接改代码

## 怎么用

直接用自然语言描述问题即可：

```
/bugfix 提交订单时页面卡住不动，等待 30 秒后超时报错
```

有日志或堆栈时一起贴上，定位更快、置信度更高；多个问题可一次提交：

```
/bugfix 订单创建报错，堆栈如下：<粘贴异常堆栈>
/bugfix 1. 提交订单超时 2. 库存数量与列表页显示不一致
```

## 修复流程

信息采集 → 信息不足追问（最多 2 轮）→ 确认后同步主分支代码 → 代码定位 → 自动修复 → 验证 → 输出报告

## 报告长什么样

每个 bug 一份 ≤ 12 行的精简报告：

```
[BUG-1] 提交订单超时 | 置信度：高 | 风险：高
根因：一句话说明
修改：文件:行号 → 改了什么
验证：编译/测试通过
遗留：无
```

置信度含义：**高** = 有日志/堆栈佐证，**中** = 代码推断，**低** = 推测。风险含义：**高** = 核心链路、影响面广或触发几率高，**中** = 部分影响或需特定条件触发，**低** = 边缘场景、影响小且触发几率低。

## 注意

- 尽量少打扰你：能在代码库自查的信息不会问；信息缺失时一次问完，最多追问 2 轮
- 同步主分支代码前会先征求你的同意，拒绝则基于本地代码分析
- 修复遵循最小改动原则，不顺手重构、不改无关代码
- 根因置信度为「低」时不会动手修，只给诊断结论建议人工介入
- 修复后自动编译/跑相关单测验证，验证失败会回退修改

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。