debug-skill
将Cursor的Debug模式移植为通用的AI代理调试技能。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：debug-skill。 它的用途是：将Cursor的Debug模式移植为通用的AI代理调试技能。 完整的 Skill 内容见：https://321skill.com/skills/debug-skill-vltansky/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“/debug ./my-react-project，这个组件的状态在点击后没有正确更新。” 它会自动启动调试服务器，插桩相关组件代码，运行你的应用，然后分析收集到的状态变更日志，指出是setState调用缺失还是异步更新问题。或者直接说：“这个API返回总是null，帮我看看。” AI会识别调试意图，引导你运行代码并分析日志，定位是请求发送错误、数据处理逻辑问题还是后端响应异常。
介绍
Debug Skill 解决了AI编程助手在调试复杂代码时，难以直观追踪程序执行状态和定位根因的问题。它通过在本地启动日志服务器，并自动插桩代码来发送运行时日志，使AI能够基于真实的执行证据来分析问题，而非仅靠静态代码推测。
使用时，只需在支持的AI代理中调用 /debug 命令并指定项目路径，或直接描述一个bug（如“为什么这个UI不更新？”），技能便会自动触发。它会读取日志文件，结合代码上下文，提供更精准的修复建议。
该技能非常适合需要频繁调试代码、排查线上故障或理解复杂遗留代码逻辑的开发人员。无论是前端状态管理问题、后端API异常，还是全栈应用的数据流错误，它都能提供基于运行时数据的洞察。
建议在使用前确保项目环境支持Node.js 18+，并拥有localhost访问权限。对于需要严格权限控制的CI/CD环境，可以使用 -g -y 选项进行静默安装。注意，它主要辅助定位问题，最终的修复和验证仍需开发者参与。
核心特点
与传统的静态代码分析技能不同，它通过动态插桩和本地日志服务器，让AI能基于程序的实际运行时数据进行调试，提供了“证据驱动”的bug定位能力，而非仅依赖代码语义推理。
注意事项
不适合调试无法在本地运行或无法插桩的第三方闭源库或服务。
常见问题
支持哪些AI代码编辑器或代理？
支持 Claude Code, OpenCode, Codex, Cursor, Antigravity 等任何支持Skill机制的代理。
安装后如何触发调试？
在AI对话中直接输入 `/debug /项目路径`，或描述bug如“帮我调试这个状态错误”，技能会自动触发。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/debug-skill-vltansky/raw/index.md 读取 debug-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/debug-skill-vltansky/raw/index.md（查看排版版本）