用途：该技能用于调试 Convex Agent 应用，帮助开发者理解智能体内部发生了什么、LLM 实际收到什么上下文、以及数据库中存储了什么，是开发可靠智能体应用的必要手段。
适用场景：智能体行为异常、LLM 回复偏离预期、排查某些上下文未被使用的原因、理解消息顺序、检查文件存储与引用、审计工具调用与结果、分析 token 用量。
主要能力与用法：
- 记录原始 LLM 请求与响应：在 Agent 构造时传入 rawRequestResponseHandler，打印 request 与 response，并可通过 ctx.runMutation 保存到日志表。
- 记录上下文消息：通过 contextHandler 查看 recent、search、inputMessages 的数量，并逐条打印消息的 role 与内容长度。
- 检查数据库表：用 query 直接查询 components.agent.tables.messages，按 threadId 过滤收集消息。
- 手动获取上下文：使用 fetchContextWithPrompt 查看将要使用的上下文消息。
- 追踪工具调用：在 createTool 的 handler 中打印调用参数与返回结果。
- 修复类型错误：为 action 显式声明 returns 与 Promise 返回类型，避免循环引用问题。
- 分析消息结构：用 listMessages 查看 order、stepOrder、role、status。
关键原则：尽早记录日志、用 console 快速检查、保存重要事件以便分析、显式声明返回类型、通过 Dashboard 检查数据库状态。
限制：资料未提供该技能的安装方式、收费、平台支持范围及具体版本要求，暂未提供相关信息。