适用于 Openclaw 的 Code Debug

一种用于识别和修复软件 Bug 的高精度诊断技能，通过最小化的代码修改实现修复。

sf0799

v0.1.0

2026年4月6日

安装

基本信息

Skill.md

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。


                  npx clawhub@latest install code-debug

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式

~/.openclaw/skills/

工作区

<project>/skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。


                  请帮我使用 Clawhub 安装 code-debug。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

更倾向于下载？

获取包含原生技能文件的ZIP压缩包。

什么是 Code Debug？

Code Debug 技能是一款专门的诊断工具，旨在帮助开发者识别并解决本地代码库中的复杂故障。通过优先进行根本原因分析而非推测性猜测，此 Openclaw Skills 扩展确保了每一次修复既安全又有效。它专注于生成最小且可论证的修复方案，在解决关键运行、逻辑或语法问题的同时，保持项目的稳定性和整洁度。

无论是处理突发崩溃、输出不一致还是测试失败，该技能都提供了结构化的工作流程来隔离问题。对于需要在应用更改前了解 Bug 技术深度的开发者而言，它极具价值，是 Openclaw Skills 生态系统中高效软件维护的基石。

Code Debug 应用场景

解决本地开发环境中的运行时崩溃或意外异常。
识别代码产生错误输出的逻辑错误源头。
调试异步工作流中的 flaky tests 或竞争条件。
调查资源泄漏、配置错误或依赖冲突。
为遗留代码问题提供详细的根本原因分析。

Code Debug 工作原理

该技能首先尝试重现错误，或将其缩小到最小的可能场景。
它会对故障类型进行分类，例如语法、运行时、逻辑或资源相关问题。
在调查过程中，会优先考虑常见的故障模式，如差一错误（off-by-one errors）、null 指针异常和过时状态。
它利用代码分析和执行日志来锁定根本原因，避免任何未经证实的假设。
生成最小、安全的补丁以解决特定的核心问题。
除非现有结构严格阻碍了适当的修复，否则该技能会避免不必要的重构。
最后一步是使用最可靠、简洁的验证方法来确认修复效果。

Code Debug 配置指南

要将此诊断功能集成到您的工作流中，请确保您的环境已为 Openclaw Skills 做好准备。

# 通过 CLI 安装 code-debug 技能
openclaw install code-debug

# 导航到您的项目根目录
cd /your/project/path

# 通过描述特定的错误或崩溃来触发该技能
# 示例: "Find the root cause of the null pointer in user_service.py"

Code Debug 数据架构与分类体系

Code Debug 技能将其发现结果组织成清晰的技术结构，以帮助开发者理解修复方案。

属性	描述
Root Cause	潜在缺陷的详细技术分析。
Impact Scope	受 Bug 影响的模块、文件或函数列表。
Reproduction Scenario	触发故障所需的最少步骤或代码片段。
Repair Direction	解决问题的推荐补丁或代码更改。
Verification Method	确认 Bug 已修复的清晰说明或命令。