java-debug-skill

关于

java-debug 是一个 Java 远程断点调试 Agent Skill（标准 SKILL.md 格式），Claude Code、Codex、Cursor 等支持 Skills 的 Agent 都能用。它会连接开启了 JDWP 的远程 JVM，由 AI 自行规划断点、等待命中，采集调用栈和局部变量，执行表达式求值和单步，最后根据实际采集到的运行时数据给出根因结论，而不是对着日志猜。核心是自研的 JDI 客户端：只依赖 JDK 内置的 com.sun.jdi，零外部依赖，以常驻 HTTP 服务模式运行，每个操作都是一条 JSON 命令，用 curl 就能驱动。 亮点 为 AI 驱动重新设计：jdb 输出的是文本，要靠 tmux + sleep 抢时序，而且默认冻结整个 JVM。这里改为 SUSPENDEVENTTHREAD，只冻结命中的线程；请求和响应都是结构化 JSON，命中时自动带回调用栈和局部变量，等待命中是带超时的阻塞等待。 断点不漏装：类还没加载时自动转为延迟断点；重载方法、同一行的多个可执行位置（包括 lambda）都会装上；多 ClassLoader 和热部署场景下，同名类的每个副本都装断点，之后加载的副本也会自动补装。 安全边界写成硬约束：命令端口只绑定 127.0.0.1，会校验 Host 头并拒绝浏览器跨站请求；eval 内置拒绝名单（System.exit、Runtime.exec 等）；命中时从不自动调用 toString()；disconnect 后被冻结的线程全部恢复。工作流还要求断点计划先经用户确认，结束时必须 disconnect。

收录记录

1. HelloGitHub·用户投稿

   2026年10月12日 · 1 次收录