SuperAPI AI 工具集

gsd-debug

测试与质量

查看项目

更新于 10-15 15:05

技能介绍

用途

gsd-debug 是一个系统化调试技能,旨在解决跨上下文重置的调试连续性问题:当调试过程被中断或上下文被清空后,它能够依靠持久化的状态继续推进,而不是从头再来。

主要能力

  • 持久化调试状态:调试会话以文件形式保存在 .planning/debug/*.md 目录下,从而在 context resets 之后仍可恢复。
  • 编排器角色:负责收集故障症状(symptoms)、启动 gsd-debugger 代理、处理检查点(checkpoints)并启动续接(continuations)。
  • 仅诊断模式:使用 --diagnose 标志时,只输出 Root Cause Report(根因报告),不应用修复。
  • 会话管理子命令:
    • list:列出调试会话
    • status <slug>:查看指定会话状态
    • continue <slug>:继续指定会话
  • 专用子代理类型:
    • gsd-debug-session-manager:在隔离上下文中管理调试的检查点/续接循环。
    • gsd-debugger:使用科学方法调查缺陷。

使用方式

命令行形式为把参数直接写在命令名之后。参数块中的内容会被解析为子命令与标志:

  • 参数以 list 开头时,执行 list 子命令。
  • 参数以 status 开头时,其后剩余部分(去除首尾空白)作为 SLUG。
  • 参数以 continue 开头时,其后剩余部分(去除首尾空白)作为 SLUG。
  • 参数包含 --diagnose 时,进入仅诊断模式,并从描述中移除该标志。
  • 其他情况按默认调试流程处理。

对于非 list/status/continue 的流程,会先检查是否存在活动会话,通过列出 .planning/debug/*.md(排除 knowledge-base.md)来判断。

适用场景

适用于需要跨多次交互、跨上下文重置持续推进的缺陷排查工作,尤其是希望以系统化、可追溯方式记录与恢复调试进展的场景。

限制

当前资料未提供关于收费、价格、支持平台及具体效果的信息。