Debugging Assistant#

调试助手，分析错误日志、建议断点、追踪执行流程、帮助识别问题根因。

Version: 1.0

Features: 错误分析、断点建议、执行追踪、根因分析

---

Quick Start#

1. 分析错误日志#

bash

# 分析 Python 错误
python3 scripts/main.py analyze-error "Traceback (most recent call last):..."

# 从文件分析
python3 scripts/main.py analyze-error --file error.log

2. 建议断点#

bash

# 为代码建议断点位置
python3 scripts/main.py suggest-breakpoints --file src/main.py

# 针对特定函数
python3 scripts/main.py suggest-breakpoints --function process_data

3. 追踪执行#

bash

# 追踪函数调用
python3 scripts/main.py trace --file src/app.py --function handle_request

---

Commands#

命令说明示例analyze-error分析错误analyze-error "Traceback..."``suggest-breakpoints建议断点suggest-breakpoints --file src.py``trace追踪执行trace --file src.py --function foo

---

Error Analysis#

Python Traceback 分析#

bash

$ python3 scripts/main.py analyze-error "Traceback (most recent call last):
  File 'src/auth.py', line 45, in login
    user = db.get_user(username)
  File 'src/db.py', line 23, in get_user
    cursor.execute(query, (username,))
psycopg2.OperationalError: connection closed"

🔍 Error Analysis
=================

Type: Database Connection Error
Severity: 🔴 High

Root Cause:
The database connection was closed before executing the query.

Possible Causes:
1. Connection pool exhaustion
2. Connection timed out
3. Database server restart

Suggested Fixes:
1. Check connection pool settings
2. Implement connection retry logic
3. Add connection health checks

File: src/db.py:23
Function: get_user

常见错误模式#

自动识别：

• ImportError / ModuleNotFoundError - 导入问题
• AttributeError - 属性访问错误
• KeyError / IndexError - 数据访问错误
• TypeError - 类型错误
• ConnectionError - 网络/连接错误
• TimeoutError - 超时错误

---

Breakpoint Suggestions#

bash

$ python3 scripts/main.py suggest-breakpoints --file src/payment.py

🔍 Breakpoint Suggestions
=========================

High Priority:
  Line 45: process_payment() - Entry point
  Line 67: validate_card() - Validation logic
  Line 89: charge_customer() - External API call

Medium Priority:
  Line 34: calculate_total() - Business logic
  Line 56: apply_discount() - Conditional logic

Tips:
- Set breakpoints before external API calls
- Watch variables: amount, currency, customer_id

---

Execution Tracing#

bash

$ python3 scripts/main.py trace --file src/api.py --function handle_request

🔍 Execution Trace
==================

Function: handle_request
File: src/api.py:23

Call Graph:
handle_request
├── authenticate_user
│   └── verify_token
├── validate_request
│   └── check_schema
├── process_data
│   ├── fetch_from_db
│   └── cache_result
└── format_response

Potential Issues:
- No error handling in process_data
- External call to fetch_from_db (line 67)

---

Configuration#

.debugging.json:

json

{
  "breakpoints": {
    "before_external_calls": true,
    "before_conditionals": true,
    "in_error_handlers": true
  },
  "error_patterns": {
    "ignore": ["DeprecationWarning"],
    "highlight": ["SecurityError", "DataLossError"]
  }
}

---

Examples#

场景 1：排查崩溃问题#

bash

# 1. 复制错误信息
python3 main.py analyze-error "$(cat error.log)"

# 2. 根据分析设置断点
python3 main.py suggest-breakpoints --file src/crash_point.py

# 3. 追踪相关函数
python3 main.py trace --function problematic_function

场景 2：性能问题排查#

bash

# 追踪执行路径
python3 main.py trace --file src/slow_endpoint.py --function handler

# 识别冗余调用

场景 3：API 错误调试#

bash

# 分析 API 错误响应
python3 main.py analyze-error "HTTP 500: Internal Server Error"

# 检查 API 处理代码
python3 main.py suggest-breakpoints --file src/api/handlers.py

---

Files#

text

skills/debugging/
├── SKILL.md                    # 本文件
└── scripts/
    ├── main.py                 # ⭐ 统一入口
    ├── error_analyzer.py       # 错误分析器
    └── tracer.py               # 执行追踪器

---

Roadmap#

• Python error analysis
• JavaScript error analysis
• Interactive debugger integration
• Log file monitoring