Agent Skills › gadievron/raptor › rr-debugger

rr-debugger

GitHub

基于 rr 记录重放的确定性调试工具，支持反向执行以排查崩溃和 ASAN 故障。提供反向单步、继续及崩溃前执行轨迹提取功能，辅助深入分析程序异常原因。

.claude/skills/crash-analysis/rr-debugger/SKILL.md gadievron/raptor

Trigger Scenarios

调试程序崩溃分析 ASAN 内存错误需要反向执行回溯问题根源

Install

npx skills add gadievron/raptor --skill rr-debugger -g -y

More Options

Non-standard path

npx skills add https://github.com/gadievron/raptor/tree/main/.claude/skills/crash-analysis/rr-debugger -g -y

Use without installing

npx skills use gadievron/raptor@rr-debugger

指定 Agent (Claude Code)

npx skills add gadievron/raptor --skill rr-debugger -a claude-code -g -y

安装 repo 全部 skill

npx skills add gadievron/raptor --all -g -y

预览 repo 内 skill

npx skills add gadievron/raptor --list

SKILL.md

Frontmatter

{
    "name": "rr-debugger",
    "description": "Deterministic debugging with rr record-replay. Use when debugging crashes, ASAN faults, or when reverse execution is needed. Provides reverse-next, reverse-step, reverse-continue commands and crash trace extraction.",
    "user-invocable": false
}

rr Deterministic Debugger

rr provides deterministic record-replay debugging with full reverse execution capabilities.

Core Workflow

Record: rr record <program> [args]
Replay: rr replay (enters gdb interface with reverse execution)

Reverse Execution Commands

All standard gdb commands work, plus reverse variants:

reverse-next / rn: Step back over function calls
reverse-step / rs: Step back into functions
reverse-continue / rc: Continue backward to previous breakpoint
reverse-stepi / rsi: Step back one instruction
reverse-nexti / rni: Step back over one instruction

Crash Trace Extraction

Regular Crashes

After rr record <crashing-program>:

rr replay
# In gdb:
reverse-next 100    # Go back 100 steps (adjust N as needed)
# Now step forward to see execution leading to crash:
next
next
...

ASAN Crashes

After rr record <asan-program>:

rr replay
# In gdb:
bt                  # View stack trace
up                  # Issue "up" commands until last app frame (before ASAN runtime)
break *$pc          # Set breakpoint at that location
reverse-continue    # Go back to last app instruction before ASAN
# Now step forward to see execution leading to fault:
next
next
...

Inspecting Variables and Memory

Standard gdb commands work at any point:

print <var>: Print variable value
print *<ptr>: Dereference pointer
x/<format> <address>: Examine memory
- x/10xb <addr>: 10 bytes in hex
- x/s <addr>: String at address
info locals: Show local variables
info args: Show function arguments