前言¶

线上报错、本地复现不了、改了几处仍对不上现象——这类问题里，难点往往不在「会不会用断点」，而在会话一开始就散：模型先猜原因、代码区没划清、中间结论没人核对，最后留下一堆临时日志和未回滚的改动。下面介绍 SkillHub 上的 Debug Ultra（@user_dc515faf/debug-session）：它把一次调试或排查整理成固定阶段，从进入状态、圈定代码、建立反馈、做可证伪诊断，到语言相关工具与收尾交接。

这是什么¶

Debug Ultra 是社区发布者 user_dc515faf 在 SkillHub 上架的 dev-programming 类 Skill，当前版本 1.1.1，来源标注为 community。官方简介将其定位为 Combined debugging workflow（组合式调试工作流）：在开始 debugging 或 investigation session 时使用。页面标签 requires_api_key=false，不依赖额外 API Key。

SkillHub 展示页：https://www.skillhub.cn/skills/user_dc515faf/debug-session
API 资源标识：https://api.skillhub.cn/user_dc515faf/debug-session

核心功能¶

以下能力均来自官方英文简介，按工作流顺序说明含义，不展开未在资料中出现的实现细节。

1. Activates caveman mode
   进入一种更「笨」、更贴近事实的调试姿态：少猜、多观察，避免过早下结论。

2. Maps the relevant code area
   先把与问题相关的代码范围画出来，缩小搜索面，减少在全仓库里漫无目的改动。

3. Builds a trusted feedback loop
   建立可信任的反馈环：假设、验证、结果要能互相核对，而不是单向叙述。

4. Runs falsifiable diagnosis
   诊断步骤要可证伪——能说明「若假设成立应看到什么、若不成立如何推翻」，而不是不可检验的猜测。

5. Uses language-specific debugging tools
   在流程中纳入与当前语言/栈匹配的调试手段（具体工具由会话上下文与 Skill 内指引决定，资料未枚举清单）。

6. Cleanup plus handoff
   结束时做清理（临时改动、调试残留等）并交接：把结论、未解项和后续建议留给下一次会话或协作者。

安装与启用¶

SkillHub 页面给出的安装方式是：让 AI 按官方安装文档处理，并指定坐标 @user_dc515faf/debug-session。

方式一：提示词安装（页面原文）

把下面意思发给当前 Agent（Cursor、Claude Code 等均可按各自 Skills 机制执行）：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_dc515faf/debug-session`。

方式二：SkillHub CLI

先确认是否已安装 CLI（文档要求安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认 ./skills/ 可能不被识别）：

command -v skillhub && skillhub --version

未安装时，官方安装脚本示例：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装本 Skill 时，将 <skills 目录> 换成你当前环境的路径。官方文档列出的常见目录包括：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

示例：

skillhub install user_dc515faf/debug-session --dir ~/.cursor/skills/

（坐标在页面上写作 @user_dc515faf/debug-session；CLI 的 install 子命令以 SkillHub 文档与 skillhub install 帮助为准。）

启用后，在 Agent 支持 Skills 的前提下，于调试或调查类任务开始时让模型加载该 Skill 即可；无需 API Key。

典型用法¶

官方未提供独立的长示例，触发条件在简介中写得很明确：

• 何时用：starting a debugging or investigation session（开始一次调试或调查会话时）。
• 怎么用：在对话中说明现象、复现条件、相关模块；由 Skill 引导走完 caveman mode → 代码区映射 → 反馈环 → 可证伪诊断 → 语言相关工具 → 清理与交接。

可复现的最小步骤：

1. 按上一节完成安装，并确认 Skill 出现在当前 Agent 的 skills 目录。
2. 新开一轮对话，描述 bug 或要调查的行为（错误信息、环境、已尝试步骤）。
3. 明确要求按 Debug Ultra 工作流推进，并在结束时要求 cleanup plus handoff 的总结。

适用场景与注意¶

适合谁

• 需要 Agent 协助查 bug、追调用链、对比假设与日志的开发者。
• 希望调试过程有阶段划分、结论可检验、收尾有交接，而不是一次性「猜修」的团队或个人。

限制与注意

• 资料为 community 来源，行为以 Skill 包内 SKILL.md 及 Agent 加载后的表现为准；本文未引用包内全文，细节以安装后本地文件为准。
• SkillHub 页面统计（截至资料抓取）：评分 100000，下载 690，安装数 0——安装数为平台计数，不代表不可用，以你本地是否装到正确 --dir 为准。
• 工作流强调可证伪与反馈环，需要你配合提供可验证信息（日志、复现步骤、版本号）；信息不足时，流程仍会卡在「无法推翻/证实假设」的阶段，这符合设计意图而非 Skill 失效。

结尾¶

Debug Ultra 的价值在于把「开始查一个问题」收敛成一条组合工作流：先稳住判断、圈代码、建反馈、做可证伪诊断、用栈内工具，最后清理并交接。若你要在 Cursor 等环境里试装，可从 SkillHub 页面或 API 标识入手：

• https://www.skillhub.cn/skills/user_dc515faf/debug-session
• https://api.skillhub.cn/user_dc515faf/debug-session