debug-that
专为AI Agent设计的轻量级调试器CLI，节省Token，精准调试。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：debug-that。 它的用途是：专为AI Agent设计的轻量级调试器CLI，节省Token，精准调试。 完整的 Skill 内容见：https://321skill.com/skills/debug-that/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
当你让AI帮你排查一段Node.js代码的逻辑错误时，可以
对AI说：“请用debug-that启动并调试`node app.js`，在`utils.js`第15行设置断点，然后查看当时的局部变量。” AI会使用`dbg launch --brk node app.js`和`dbg break utils.js:15`等命令进行精准调试，并用`@v1`等形式向你反馈变量状态，极大节省沟通成本。
介绍
debug-that 是一款专为AI Agent设计的调试器命令行工具，旨在解决AI在协助编程时因打印调试（print-debugging）而浪费大量Token的问题。它通过提供精准的程序状态检查（如变量、调用栈、断点），并利用简短的@ref引用符来最小化输出，显著提升了AI调试代码的效率和Token经济性。
该工具使用非常简单，通过dbg命令即可启动或附加到各种运行时的进程进行调试。它支持Node.js（JavaScript/TypeScript）、Bun、LLDB（C/C++/Rust/Swift）、Python（debugpy）等多种语言和运行时，并能自动检测或通过--runtime参数指定适配器。核心操作包括设置断点、单步执行、查看变量和调用栈、实时修改变量值，甚至支持JavaScript/TypeScript的热补丁（hotpatch）功能。
debug-that 主要面向需要AI辅助进行代码调试的开发者，尤其是那些在Claude、Cursor等AI编程工具中，希望AI能更高效、更精准地理解和修复代码问题的场景。它让AI Agent能够像人类开发者使用IDE调试器一样，深入程序内部进行探查，而无需依赖冗长的日志输出。
使用建议：在启动调试会话时，善用--brk参数让程序在入口处暂停，方便AI第一时间设置断点。调试过程中，多使用@v1、@f0这类简洁的引用符来指代变量或堆栈帧，可以极大减少与AI的通信开销。注意，对于尚在规划中的语言（如Deno、Go、Java），功能支持可能有限。
核心特点
与通用调试器不同，debug-that专为AI Agent交互优化，核心是`@ref`引用系统和极简输出，旨在用最少的Token传递最精确的调试状态，这是其区别于其他调试工具（如直接使用Node Inspector）的关键。
注意事项
目前对Deno、Go、Java等语言的支持尚在规划中，功能不完全；部分高级调试功能可能依赖特定运行时的协议支持。
常见问题
debug-that 和普通调试器有什么区别？
专为AI设计，输出极简并使用`@ref`引用符，旨在节省AI交互的Token消耗，提升调试效率。
支持调试Python代码吗？
支持，通过debugpy适配器，使用DAP协议进行调试。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/debug-that/raw/index.md 读取 debug-that 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/debug-that/raw/index.md（查看排版版本）