DEBUG

技能文档

---
name: debug
description: 根据用户描述的问题现象，分析代码库定位 bug 根因，输出结构化诊断报告（含根因、修复方案、影响范围、风险等级、验证点）。当用户报告 bug、定位 bug、找BUG、系统异常、功能缺陷、性能问题时触发。仅输出诊断报告，不自动修改代码。
title: DEBUG
category: 开发工具
---

## 边界

只输出诊断报告，不修改任何代码，修复方式由开发决定。

## 技能工作流

### 信息收集与追问

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

### 代码分析

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

定位策略：

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

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

### 输出报告

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

```
[BUG-N] 一句话标题 | 置信度：高/中/低 | 风险：高/中/低
根因：一句话
修复：文件:行号 → 改法（多条用分号分隔，每条一行）
影响：一句话
验证：一句话
```

## 输出规范

- 使用中文输出，不输出分析过程、排查路径和代码片段。
- 置信度：高=有日志/堆栈佐证，中=代码推断，低=推测。
- 风险由影响面和触发几率综合判断：高=核心链路、影响面广或触发几率高，中=部分影响或需特定条件触发，低=边缘场景、影响小且触发几率低。
- 超过 2 轮追问仍信息不足时，基于已有信息输出报告并标注低置信度。
- 禁止编造文件路径或行号；无证据时禁止标注「高」置信度。
- 分析中发现的其他问题只报告，不顺手修改。

使用说明

# DEBUG（debug）

根据你描述的问题现象，自动分析代码库定位 bug 根因，输出一份可直接交给开发修复的结构化诊断报告。**只诊断，不改代码**。

## 什么时候用

- 页面卡住、超时报错、数据对不上等功能缺陷
- 有错误日志或堆栈，但不知道问题出在哪
- 性能变慢，想定位瓶颈代码

## 怎么用

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

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

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

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

## 诊断流程

信息采集 → 信息不足追问（最多 2 轮）→ 确认后同步主分支代码 → 代码定位 → 数据取证（有数据库/日志工具时）→ 输出报告

## 报告长什么样

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

```
[BUG-1] 提交订单超时 | 置信度：高 | 风险：高
根因：一句话说明
修复：文件:行号 → 改法
影响：一句话说明
验证：一句话说明
```

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

## 注意

- 尽量少打扰你：能在代码库自查的信息不会问；信息缺失时一次问完，最多追问 2 轮
- 同步主分支代码前会先征求你的同意，拒绝则基于本地代码分析
- 不会修改任何代码文件，是否修复由你决定

如何安装此技能？

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