用途：在 Rider 打开的项目中，用调试器证据回答静态阅读代码无法确定的运行时问题，例如实际取值、分支走向、调用顺序、线程上下文，或执行是否到达某个代码位置。适用于 .NET/C#、F#、VB、C++、Unity、Unreal Engine 等 GameDev 项目。
主要能力：通过 execute_tool(command="<tool> --arg value ...") 调用 xdebug_* MCP 工具，包括设置断点、启动调试会话、控制会话、获取调用栈、读取帧变量、按路径取值、求值表达式，以及 get_run_configurations / execute_run_configuration。支持在库与反编译源码中设断点，支持 tracepoint 式日志（--isLogMessage true --suspendPolicy NONE）。
使用方式：先做最小静态排查，再判断是否需要调试器。启动前调用 xdebug_get_debugger_status 复用已有会话；用 xdebug_list_breakpoints 记录基线并临时禁用无关的用户断点；设置首个断点后启动会话，每次 RESUME 后执行 WAIT_FOR_PAUSE；暂停时用 xdebug_get_stack 与取值工具收集证据。调试测试时传 --filePath + --line 指向测试定义，或使用 --configurationName。
限制：仅在调试器 MCP 工具可用时使用，最低需要 xdebug_set_breakpoint、xdebug_start_debugger_session、xdebug_control_session、xdebug_get_stack、至少一个取值工具和 get_run_configurations，否则应说明阻塞并改用回退方案。Rider 调试器非 JVM，breakpointErrorsTail / tracepointOutputsTail 不可依赖。不得在未获明确批准时修改项目配置。缺少运行时证据前不得断言根因或修改运行时行为。调试结束后清理 agent 断点、恢复用户断点基线并停止会话。