gsd-forensics 是 open-gsd/gsd-core 项目中的一个技能，定位为「失败 GSD 工作流的事后调查」，用于诊断工作流失败或卡住时的根本原因。
用途：当 GSD 工作流出现失败或卡住的情况时，该技能帮助用户理解根本原因并采取纠正措施。它属于事后调查（post-mortem investigation）性质，聚焦于诊断「出了什么问题」。
主要能力：
- 从所有可用数据源收集证据。
- 至少检查 4 种异常类型：卡住循环（stuck loop）、缺失产物（missing artifacts）、被放弃的工作（abandoned work）、崩溃/中断（crash/interruption）。
- 将结构化的事后调查报告写入 .planning/forensics/report-{timestamp}.md。
- 内联展示报告，包含发现（findings）、异常（anomalies）与建议（recommendations）。
- 在存在可操作发现时，提供创建 GitHub 问题的选项。
- 提供交互式调查（interactive investigation），用于更深入的分析。
使用方式： 该技能通过命令方式触发，用户可在命令名之后输入问题描述作为参数。参数块中的文本是用户输入的数据，而非模板指令；空块表示未传入参数，此时技能会主动询问问题描述（问题描述为可选，未提供时会询问）。执行上下文引用 @~/.claude/gsd-core/workflows/forensics.md。
输出：调查报告保存至 .planning/forensics/，同时在对话中内联展示，并可选地创建 issue。
成功标准（success criteria）：
- 从所有可用数据源收集证据。
- 至少检查 4 种异常类型（卡住循环、缺失产物、被放弃的工作、崩溃/中断）。
- 结构化事后调查报告写入 .planning/forensics/report-{timestamp}.md。
- 报告内联展示，包含发现、异常和建议。
- 提供交互式调查以进行更深入分析。
- 若存在可操作发现，提供创建 GitHub 问题的选项。
关键规则（critical rules）：
- 只读调查：在事后调查期间不得修改项目源文件，仅可写入调查报告并更新 STATE.md 会话跟踪。
- 抹除敏感数据：从报告和 issue 中剥离绝对路径、API 密钥、令牌。
- 发现须有证据支撑：每个异常都必须引用具体的提交、文件或状态数据。
- 无证据不推测：若数据不足，应明确说明，不得捏造根本原因。
适用场景： 适用于 GSD 工作流失败或卡住、需要进行事后根因诊断与纠正建议的情形。
限制： 该技能仅执行只读调查，不会修改项目源文件；报告与 issue 中的敏感数据会被抹除；在数据不足时不会给出无证据的推测。关于具体收费、价格、平台支持范围等信息，当前资料暂未提供。