用途：gsd-debug 用于系统化调试，核心思路是把调查工作交给独立子代理，避免主上下文被大量文件阅读和假设验证消耗，并在上下文重置后通过持久化状态继续排查。
主要能力：编排角色负责收集症状、启动 gsd-debugger 代理、处理检查点以及启动续接代理。调查状态写入 .planning/debug/{slug}.md，可跨上下文重置保留。支持检查已有活动会话、恢复会话或开始新问题。
使用方式：先检查活动会话，命令为 ls .planning/debug/*.md 2>/dev/null | grep -v resolved | head -5。初始化上下文使用 node {{PLATFORM_ROOT}}/get-shit-done/bin/gsd-tools.cjs state load，并解析调试器模型 node {{PLATFORM_ROOT}}/get-shit-done/bin/gsd-tools.cjs resolve-model gsd-debugger --raw。收集症状时依次询问预期行为、实际行为、错误信息、时间线和复现方式。随后以 subagent_type="gsd-debugger" 启动代理，传入症状、模式和调试文件路径。代理返回根因、检查点或调查无结论时，编排角色分别提供修复、计划修复、手动修复、继续调查或补充上下文等选项；检查点响应后启动续接代理继续调试。
适用场景：需要跨上下文重置持续追踪的复杂缺陷、需要先确认根因再修复的调试任务，以及希望保持主上下文精简的交互式排查。
限制：资料未提供具体平台支持范围、安装方式、收费信息或性能数据；部分命令中的 {{PLATFORM_ROOT}} 与 {{COMMAND_PREFIX}} 为占位符，需按实际环境替换。