bug-hunter¶

Skill 简介¶

在软件开发的过程中，调试和修复代码中的错误往往是开发人员最耗时且最令人头疼的任务之一。无论是因为复杂的堆栈跟踪、难以复现的生产环境崩溃，还是用户报告的不稳定行为，定位和解决这些问题通常需要丰富的经验和大量的时间投入。为了帮助开发人员更高效地处理这些问题，bug-hunter 应运而生。

bug-hunter 是一个基于人工智能的调试助手，旨在通过分析错误日志和堆栈跟踪，快速识别问题的根本原因，并提供相应的修复建议。它不仅能够理解复杂的错误信息，还能跟踪代码库中的错误模式，帮助开发人员更快地定位和解决问题。无论是初学者还是经验丰富的开发者，bug-hunter 都能成为他们日常开发中的得力助手。

主要功能¶

bug-hunter 提供了多种强大的功能，帮助开发人员在不同场景下高效地调试和修复错误。以下是其核心功能的详细介绍：

错误分析：
bug-hunter 能够深入分析错误日志和堆栈跟踪，识别出最可能的原因，并提供详细的调试步骤和修复建议。例如，当遇到“TypeError: Cannot read properties of undefined (reading 'url')”这样的错误时，bug-hunter 会分析出可能的原因，如 API 响应缺少数据、JSON 解析错误或网络超时，并给出相应的调试和修复建议。

bash You: "TypeError: Cannot read properties of undefined (reading 'url')" Trace: [3 ranked causes with probabilities, debugging steps, fix]

生产环境崩溃分析：
当应用程序在本地运行正常，但在生产环境中崩溃时，bug-hunter 可以通过环境差异分析，找出可能导致问题的因素，如环境变量缺失、Node.js 版本不匹配、构建模式差异或数据库连接问题等。

bash You: "Works locally, crashes in production" Trace: [Environment diff analysis, common causes, debugging steps]

错误报告生成：
bug-hunter 可以根据用户报告的错误，生成结构化的错误报告，包括重现步骤和问题的严重程度。这有助于开发团队更系统地跟踪和解决用户反馈的问题。

bash You: "Users report checkout sometimes fails" Trace: [Structured bug report with reproduction steps and severity]

回归测试检查：
在每次部署后，bug-hunter 可以分析最近的代码更改，识别出可能引入的新错误或回归问题。它会将这些更改与已知的失败模式进行对比，帮助开发人员及时发现和修复潜在的问题。

bash You: "Did last deploy break anything?" Trace: [Analyzes recent changes against known failure patterns]

错误模式跟踪：
bug-hunter 能够跨代码库跟踪错误模式，帮助开发人员识别出常见的错误类型和趋势，从而在未来的开发中避免类似的问题。

使用场景¶

日常调试：
在日常开发中，bug-hunter 可以帮助开发人员快速定位和修复代码中的错误，节省大量的调试时间。
生产环境问题排查：
当应用程序在生产环境中出现问题时，bug-hunter 可以通过环境差异分析和错误模式跟踪，帮助开发人员快速找到问题的根源。
用户反馈处理：
当用户报告错误时，bug-hunter 可以生成结构化的错误报告，帮助开发团队更系统地处理和解决用户反馈的问题。
回归测试：
在每次部署后，bug-hunter 可以帮助开发人员及时发现和修复新引入的错误，确保应用程序的稳定性。
错误模式分析：
通过跟踪和分析错误模式，bug-hunter 可以帮助开发团队识别出常见的错误类型和趋势，从而在未来的开发中避免类似的问题。

如何使用¶

安装¶

首先，确保你已经安装了 OpenClaw 平台。然后，按照以下步骤安装 bug-hunter：

mkdir -p ~/.openclaw/agents/bug-hunter/agent
cp SOUL.md ~/.openclaw/agents/bug-hunter/agent/

openclaw agents add bug-hunter --workspace ~/.openclaw/agents/bug-hunter

配置¶

安装完成后，可以通过以下命令启动与 bug-hunter 的对话：

openclaw chat bug-hunter "Got this error: [paste error]"

前置条件¶

OpenClaw 平台已安装并配置完成。
错误日志或堆栈跟踪信息完整且准确，以便 bug-hunter 进行有效的分析。

示例¶

示例 1：错误分析¶

假设你在开发过程中遇到了以下错误：

TypeError: Cannot read properties of undefined (reading 'url')

你可以将错误信息发送给 bug-hunter 进行分析：

openclaw chat bug-hunter "TypeError: Cannot read properties of undefined (reading 'url')"

bug-hunter 可能会返回如下结果：

Likely causes:
1. API response missing data (70%)
2. JSON parse returned error object (20%)
3. Network timeout (10%)

Debug: console.log(data) before url check
Fix: Handle data.error case explicitly

示例 2：生产环境崩溃分析¶

当应用程序在生产环境中崩溃时，你可以提供相关信息给 bug-hunter：

openclaw chat bug-hunter "Works locally, crashes in production"