gsd-forensics Skill：GSD 工作流失败后的自动化尸检工具

Skill超级捕获手 技术创作者 2026-08-04 10 阅读

gsd-forensics Skill：GSD 工作流失败后的自动化尸检工具

CoCo 项目的 GSD（Get Shit Done）系统是一个含 68 个 Skills 和 24 个 Agents 的多阶段开发编排引擎，擅长将复杂代码任务分解为可验证的阶段执行。但任何复杂系统都有失败场景——阶段卡死、构件丢失、进程中断。gsd-forensics 是 GSD 系统的「事后尸检 Skill」：当一次 GSD 工作流执行失败或卡顿时，它读取 git 历史、.planning/ 阶段工件和文件系统状态，从 4 个维度（卡死循环、缺失构件、放弃的工件、崩溃/中断）系统性诊断根因，生成结构化诊断报告并存入 .planning/forensics/ 目录。2026 年 8 月 4 日同日上架 SkillHub.club，是 GSD 系列中专注于「失败溯源」的唯一 Skill。

功能与原则

gsd-forensics 的核心原则是「只读调查，不动代码」。执行过程中绝对不修改项目源文件，只生成诊断报告并更新 STATE.md 的会话追踪记录。同时，所有敏感数据（API Key、Token、绝对路径）在报告和 issue 中会被自动脱敏。

工作流程：接收用户提供的 $ARGUMENTS（问题描述，可选）→ 从 5 个数据源并行读取（git log、git status/diff、.planning/STATE.md、.planning/ROADMAP.md、各阶段 PLAN/SUMMARY/VERIFICATION）→ 执行 forensics workflow → 至少覆盖 4 种异常类型 → 生成结构化报告 → 提供深度调查和 GitHub Issue 创建选项。

认可度

  • GitHub Star：196（截至 2026-08-04，coco-research/coco 母项目）
  • SkillHub 新鲜度：2026-08-04 新上架，出现在 SkillHub.club 首页「Recently added」区块
  • 生态定位：CoCo GSD Bundle 68 个 Skills 之一，专注「工作流事后分析」
  • 支持 Agent：Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw、GitHub Copilot、Cursor、Windsurf、Cline、Roo Code、Kiro、Junie、Augment Code、Warp、Goose（共 15 个主流 AI 编程工具）

链接

GitHub（母项目，含 gsd-forensics 源码）：
https://github.com/coco-research/coco

SkillHub 页面：
https://skillhub.club/skills/coco-research-coco-gsd-forensics

原作者

coco-research — 开源 AI 编程增强组织，专注于将多 Agent 协作、项目记忆、架构一致性验证等能力封装为模块化 Skills 和命令体系。旗下项目 CoCo Super Intelligence 定位为「AI 编程工具的编排层」，非模型非 Agent 框架，而是纯 Markdown/YAML 的工作流资产库，100% 本地运行，无遥测。

介绍

GSD 工作流的执行会留下大量元数据：每个阶段的 PLAN.md（计划意图）、SUMMARY.md（执行摘要）、VERIFICATION.md（验证结果）、CONTEXT.md（上下文快照），以及 git log 中的提交记录和时间线。当一个阶段失败或工作流卡死时，这些信息散落在各处，开发者需要手动拼凑才能还原真相。

gsd-forensics 将这个过程自动化。它以只读方式全面扫描所有可用数据源，检查 4 类典型异常：

  1. 卡死循环（Stuck Loop）：同一阶段反复重试但无进展
  2. 缺失工件（Missing Artifacts）：某个阶段的输出文件缺失，导致后续阶段无法继续
  3. 放弃的工件（Abandoned Work）：某个阶段开始执行但从未完成，中途被放弃
  4. 崩溃/中断（Crash/Interruption）：进程被强制中断，留下不完整状态

每发现一个异常，必须引用具体的 commit hash、文件路径或状态数据，绝不凭空猜测根因。报告输出到 .planning/forensics/report-{timestamp}.md，同时展示在对话中，用户可以选择继续深度调查，或直接生成 GitHub Issue 供后续处理。

特点

  • 只读调查：绝不修改项目源文件，只写诊断报告和更新 STATE.md，保护现场不被破坏
  • 敏感数据脱敏：自动过滤 API Key、Token、绝对路径，防止诊断报告泄露生产凭证
  • 证据驱动：每个结论必须引用具体 commit、文件或状态数据，无证据不推测
  • 4 类异常覆盖：卡死循环 / 缺失工件 / 放弃工件 / 崩溃中断，系统性覆盖工作流故障模式
  • 可选 GitHub Issue 生成：发现可操作的根因时，自动提议创建 Issue 供人工跟进
  • 交互式深度调查：基础报告完成后，提供继续深挖的选项，适合复杂多阶段故障场景

使用方法

前置条件

# 确保 GSD 工作流曾经运行过，.planning/ 目录存在
# 无需额外安装，gsd-forensics 是 CoCo GSD Bundle 的一部分

运行尸检

# 基础用法：直接运行，使用交互式问答描述问题
/gsd-forensics

# 带问题描述运行（跳过交互，直接开始调查）
/gsd-forensics "第三阶段 verify 反复失败，状态停留在 phase-3"

读取报告

诊断完成后，报告会出现在对话中，并同时写入文件：

.planning/forensics/report-20260804-143052.md

报告结构示例：

# GSD Forensics Report
Generated: 2026-08-04 14:30:52
Workflow: payment-refactor

## Evidence Gathered
- Git log: 23 commits, time gap detected at 14:22-14:31 (9 min)
- .planning/phases/phase-3/PLAN.md: exists
- .planning/phases/phase-3/SUMMARY.md: MISSING ← anomaly
- git status: clean (no uncommitted work)

## Anomalies Detected
### 1. Abandoned Work (HIGH)
Phase 3 started but SUMMARY.md never written.
Evidence: PLAN.md exists at 14:22, no subsequent commits.
Recommendation: Rerun phase-3 from plan-3.

### 2. Time Gap (LOW)
9-minute gap in git log at 14:22-14:31.
Evidence: commit `a3f9c12` at 14:22, next commit `b7d2e45` at 14:31.
Recommendation: Investigate external interruption (SIGKILL? network?).

## Recommendations
- Rerun: /team:ship --resume-from phase-3
- Create GitHub issue? [Y/n]

使用场景与人群

适用场景：
– GSD 多阶段工作流中途失败，需要搞清楚「卡在哪一步、为什么」
– 长时间运行的 AI 自动化任务第二天发现没完成，需要还原现场
– Code Review 或事后分析时，向团队解释某个功能为何延期或失败
– 调试 CoCo 自身的 GSD 编排行为，验证工作流是否按设计执行

目标用户：
– 使用 CoCo GSD Bundle 进行复杂项目开发或重构的工程师
– 需要给团队或管理者提供「任务失败原因」结构化说明的技术负责人
– 正在构建自己的多阶段 AI Agent 工作流，希望借鉴失败溯源方法论的开发者

输入与输出案例

案例 1：阶段验证反复失败

Input：/gsd-forensics "phase-3 verify 一直失败，但看不出为什么"

Output：
→ Reads .planning/phases/phase-3/VERIFICATION.md
→ Finds: expected output file `dist/api.js` does not exist
→ git log shows: build step was interrupted at commit `7f3a91b`
→ Anomaly: Abandoned Work (phase-3 build step never completed)
→ Report generated with recommendation: Rerun build step before verify

案例 2：长时间无响应后的诊断

Input：/gsd-forensics "昨晚跑了 3 小时，早上发现停在 phase-2"

Output：
→ Scans git log: 2h gap between commits on phase-2 branch
→ STATE.md shows: phase-2 completed at 22:31, phase-3 never started
→ No crash evidence in git or filesystem
→ Anomaly: External interruption (possible OOM kill or manual Ctrl+C)
→ Recommendation: Resume from phase-3 with /team:ship --resume-from phase-3

GitHub: https://github.com/coco-research/coco

评论区

0 条评论

登录后可评论。

Skill超级捕获手 10 阅读