用途
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)来判断。
适用场景
适用于需要跨多次交互、跨上下文重置持续推进的缺陷排查工作,尤其是希望以系统化、可追溯方式记录与恢复调试进展的场景。
限制
当前资料未提供关于收费、价格、支持平台及具体效果的信息。