什么是 debug-pro？

debug-pro 技能提供了一套结构化方法论，旨在消除软件开发生命周期中的盲目猜测。通过将此技能集成到 Openclaw Skills 中，开发者可以采用严谨的 7 步协议：重现、隔离、假设、检测、验证、修复和回归测试，确保 Bug 不仅仅是被修复，而是被深刻理解并防止再次发生。

除了工作流之外，它还是适用于 Node.js、Python、Swift 和 Web 布局调试等多种环境的技术速查表。它使工程师能够使用行业标准的 CLI 工具和诊断命令，解决内存泄漏、水合不匹配和网络瓶颈等复杂问题。

下载入口:https://github.com/openclaw/skills/tree/main/skills/cmanfre7/debug-pro

安装与下载

1. ClawHub CLI

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

2. 手动安装

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

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

3. 提示词安装

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

debug-pro 应用场景

• 排查持续性的应用崩溃或间歇性的竞态条件。
• 识别 Python 和 Node.js 环境中内存泄漏或性能退化的根源。
• 使用自动化的 git bisect 工作流缩小导致回归的提交范围。
• 使用 curl、dig 和 lsof 诊断网络延迟或连接问题。
• 解决复杂 Web 应用中的前端布局问题和 React 特有的水合错误。

1. 遵循 7 步协议，系统地重现并隔离特定 Bug。
2. 利用语言专用调试器（如 Python 的 pdb 或 Node.js 的 inspect-brk 标志）对代码进行检测。
3. 运行诊断命令以分析系统资源、端口占用和网络流量。
4. 应用最小化修复，并根据初始假设进行验证。
5. 进行回归测试，确保修复是永久性的，并在代码库中记录。

debug-pro 配置指南

要在 Openclaw Skills 生态中使用 debug-pro，请确保您的开发环境已安装必要的语言运行时。您可以使用以下诊断命令验证系统状态：

# 检查系统资源使用情况
top -l 1 | head -10

# 验证磁盘空间
df -h

# 在启动调试器前检查端口冲突
lsof -i :3000

debug-pro 数据架构与分类体系

该技能根据错误模式和环境类型组织排障数据。下表总结了此技能中常用的错误映射：

debug-pro

Systematic debugging methodology and language-specific debugging commands.

The 7-Step Debugging Protocol

1. Reproduce — Get it to fail consistently. Document exact steps, inputs, and environment.
2. Isolate — Narrow scope. Comment out code, use binary search, check recent commits with git bisect.
3. Hypothesize — Form a specific, testable theory about the root cause.
4. Instrument — Add targeted logging, breakpoints, or assertions.
5. Verify — Confirm root cause. If hypothesis was wrong, return to step 3.
6. Fix — Apply the minimal correct fix. Resist the urge to refactor while debugging.
7. Regression Test — Write a test that catches this bug. Verify it passes.

Language-Specific Debugging

JavaScript / TypeScript

# Node.js debugger
node --inspect-brk app.js
# Chrome DevTools: chrome://inspect

# Console debugging
console.log(JSON.stringify(obj, null, 2))
console.trace('Call stack here')
console.time('perf'); /* code */ console.timeEnd('perf')

# Memory leaks
node --expose-gc --max-old-space-size=4096 app.js

Python

# Built-in debugger
python -m pdb script.py

# Breakpoint in code
breakpoint()  # Python 3.7+

# Verbose tracing
python -X tracemalloc script.py

# Profile
python -m cProfile -s cumulative script.py

Swift

# LLDB debugging
lldb ./MyApp
(lldb) breakpoint set --name main
(lldb) run
(lldb) po myVariable

# Xcode: Product → Profile (Instruments)

CSS / Layout

/* Outline all elements */
* { outline: 1px solid red !important; }

/* Debug specific element */
.debug { background: rgba(255,0,0,0.1) !important; }

Network

# HTTP debugging
curl -v https://api.example.com/endpoint
curl -w "@curl-format.txt" -o /dev/null -s https://example.com

# DNS
dig example.com
nslookup example.com

# Ports
lsof -i :3000
netstat -tlnp

Git Bisect

git bisect start
git bisect bad              # Current commit is broken
git bisect good abc1234     # Known good commit
# Git checks out middle commit — test it, then:
git bisect good  # or  git bisect bad
# Repeat until root cause commit is found
git bisect reset

Common Error Patterns

Quick Diagnostic Commands

# What's using this port?
lsof -i :PORT

# What's this process doing?
ps aux | grep PROCESS

# Watch file changes
fswatch -r ./src

# Disk space
df -h

# System resource usage
top -l 1 | head -10