用途:针对失败或卡住的 GSD 工作流进行事后调查,帮助用户理解根因并采取纠正措施。输出为保存到 .planning/forensics/ 的取证报告,同时内联展示,并可选创建 issue。
主要能力:从所有可用数据源收集证据;至少检查 4 类异常(卡死循环、缺失产物、被放弃的工作、崩溃/中断);生成结构化报告 report-{timestamp}.md;结合发现、异常与建议进行内联展示;提供交互式深入调查;若发现可操作问题,提供创建 GitHub issue。
使用方式:通过提及 $gsd-forensics 调用该技能,其后的用户文本作为 {{GSD_ARGS}} 参数;未提供参数时会询问问题描述。该技能适配 Codex 环境:AskUserQuestion 映射为 request_user_input,Task() 映射为 spawn_agent,多选需用连续单选或编号自由列表替代;执行模式下若 request_user_input 被拒绝,则改用纯文本编号列表并选取合理默认值。
关键限制:调查为只读,不得修改项目源文件,只写入取证报告并更新 STATE.md 会话跟踪;报告中须脱敏绝对路径、API key 与令牌;每条异常必须引用具体 commit、文件或状态数据;数据不足时须明确说明,不得凭空推测根因。
适用场景:GSD 工作流失败、停滞或中断后的排障与复盘。