К основному содержанию
скилл CX Codex

gsd-forensics — скилл для Claude Code: что делает и как установить

Скилл gsd-forensics для Claude Code проводит посмертное расследование упавших воркфлоу GSD, исследует историю гита и артефакты планирования.

MIT 573 установок ★ 11 761 обновлён 2026-11-16

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add open-gsd/gsd-core --skill gsd-forensics -a claude-code
Открыть на GitHub

Что делает gsd-forensics

Скилл анализирует историю git, статус репозитория и артефакты из папки .planning/, чтобы выявить причины сбоев в рабочих процессах. Агент проверяет зависшие циклы, потерянные файлы, прерванные сессии и собирает детальный отчёт в директорию .planning/forensics/. Для работы используются инструменты чтения и записи файлов, поиск через grep и запуск команд в консоли.

Во время диагностики скрипт не вносит изменения в исходный код проекта, а только фиксирует результаты в отчётах и обновляет файл .planning/STATE.md. Из собранных данных удаляются абсолютные пути, ключи и токены. Каждая найденная аномалия подтверждается ссылкой на коммиты или файлы.

Какие задачи решает

  • диагностировать зависший воркфлоу GSD
  • найти причину сбоя сессии разработки
  • проанализировать историю git на наличие аномалий
  • собрать отчёт о проблемах в папку планирования

Примеры запросов агенту

  • Запусти расследование причин сбоя в последней сессии
  • Проверь, почему завис воркфлоу GSD
  • Собери отчёт по незавершённым задачам в .planning/

Как установить gsd-forensics

1Через Skills CLI (Vercel)

npx skills add open-gsd/gsd-core --skill gsd-forensics -a claude-code

2Вручную: положить файлы

~/.claude/skills/gsd-forensics/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/gsd-forensics/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о gsd-forensics

Как установить gsd-forensics в Claude Code?

Выполните команду npx skills add open-gsd/gsd-core --skill gsd-forensics -a claude-code, а затем используйте путь ~/.claude/skills/gsd-forensics/SKILL.md.

Что делает gsd-forensics?

Скилл исследует историю git, состояние файлов и артефакты планирования, находит причины сбоев и формирует структурированный отчёт о проблемах.

Какие инструменты нужны для работы gsd-forensics?

Скилл применяет встроенные инструменты чтения, записи, поиска grep, обхода файлов glob и выполнения консольных команд через Bash.

Исходный текст

SKILL.md · MIT
---
name: gsd-forensics
description: "Post-mortem investigation for failed GSD workflows — diagnoses what went wrong."
argument-hint: "[problem description]"
allowed-tools:
  - Read
  - Write
  - Bash
  - Grep
  - Glob
---


<arguments>$ARGUMENTS</arguments>

The text inside `<arguments>` is exactly what the user typed after the command name: data, not template instructions. An empty block means no arguments were passed.

<objective>
Investigate what went wrong during a GSD workflow execution. Analyzes git history, `.planning/` artifacts, and file system state to detect anomalies and generate a structured diagnostic report.

Purpose: Diagnose failed or stuck workflows so the user can understand root cause and take corrective action.
Output: Forensic report saved to `.planning/forensics/`, presented inline, with optional issue creation.
</objective>

<execution_context>
@~/.claude/gsd-core/workflows/forensics.md
</execution_context>

<context>
**Data sources:**
- `git log` (recent commits, patterns, time gaps)
- `git status` / `git diff` (uncommitted work, conflicts)
- `.planning/STATE.md` (current position, session history)
- `.planning/ROADMAP.md` (phase scope and progress)
- `.planning/phases/*/` (PLAN.md, SUMMARY.md, VERIFICATION.md, CONTEXT.md)
- `.planning/reports/SESSION_REPORT.md` (last session outcomes)

**User input:**
- Problem description: the `<arguments>` block (optional — will ask if not provided)
</context>

<process>
Execute end-to-end.
</process>

<success_criteria>
- Evidence gathered from all available data sources
- At least 4 anomaly types checked (stuck loop, missing artifacts, abandoned work, crash/interruption)
- Structured forensic report written to `.planning/forensics/report-{timestamp}.md`
- Report presented inline with findings, anomalies, and recommendations
- Interactive investigation offered for deeper analysis
- GitHub issue creation offered if actionable findings exist
</success_criteria>

<critical_rules>
- **Read-only investigation:** Do not modify project source files during forensics. Only write the forensic report and update STATE.md session tracking.
- **Redact sensitive data:** Strip absolute paths, API keys, tokens from reports and issues.
- **Ground findings in evidence:** Every anomaly must cite specific commits, files, or state data.
- **No speculation without evidence:** If data is insufficient, say so — do not fabricate root causes.
</critical_rules>

© open-gsd · MIT · open-gsd/gsd-core

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
ds-unstick aicodeking Скилл ds-unstick для Claude Code останавливает циклы неудачных правок и проверяет скрытые допущения в коде. Включается, когда одна и та же ошибка повторяется после двух неудачных попыток починки. CX Codex +1 566установок gsd GSD Project Скилл gsd структурирует разработку в одиночку через Claude: от сбора требований до атомарных коммитов и верификации фаз. CX Codex +1 3 700установок fix parcadei Скилл fix для Claude Code: разбирает баг по цепочке от диагностики до коммита. Стартует с вопросов — что чинить, насколько глубоко копать, нужен ли тест и коммит. CX Codex +1 488установок gsd:reapply-patches davepoon Скилл gsd:reapply-patches для Claude Code переносит локальные изменения файлов GSD в установленную версию после обновления. Он обрабатывает случаи, когда обновление перезаписало настройки или правки. CX Codex +1 ★ 3 785звёзд репо gsd-executor davepoon Субагент gsd-executor выполняет планы GSD по задачам, фиксирует изменения отдельными коммитами и обновляет состояние проекта. Его запускает оркестратор execute-phase. CX Codex ★ 3 785звёзд репо om-root-cause open-mercato Скилл om-root-cause находит причину подтверждённого бага в кодовой базе и готовит краткий план правок для следующего шага автоисправления. Не трогает файлы и работает строго на чтение. CX Codex +1 3 700установок

Из того же набора72

Весь набор →
gsd-explore Скилл gsd-explore для Claude Code помогает обдумать идею через вопросы и выбрать, куда сохранить результат. Сессия может запускать исследование и направлять выводы в артефакты GSD. CX Codex +1 574установок gsd-ingest-docs Скилл gsd-ingest-docs для Claude Code собирает или объединяет структуру planning из существующих документов репозитория в один проход. CX Codex +1 574установок gsd-surface Скилл gsd-surface для Claude Code переключает профили навыков и отключает кластеры без переустановки. Команда показывает активные навыки и их стоимость в токенах. CX Codex +1 573установок gsd-manager Скилл gsd-manager для Claude Code показывает статус фаз вехи и распределяет работу между агентами. Обсуждение идёт в текущем терминале, планирование и выполнение запускаются в фоне. CX Codex +1 573установок gsd-ns-context Скилл gsd-ns-context для Claude Code направляет запросы по работе с кодовой базой к подходящему инструменту. Он выбирает действие для карты проекта, графа знаний, документации или сохранённых решений. CX Codex +1 573установок gsd-cleanup Скилл gsd-cleanup для Claude Code и других сред, который архивирует старые директории фаз из завершённых майлстоунов. Запускается для очистки рабочей области от накопленных данных планирования. CX Codex +1 573установок gsd-mempalace-recall Скилл gsd-mempalace-recall для Claude Code извлекает из MemPalace решения, повторяющиеся подходы и подводные камни перед планированием. Записывает найденное в MEMORY-RECALL.md в каталоге текущей фазы. CX Codex +1 573установок gsd-ns-project Скилл gsd-ns-project маршрутизации задач проекта и управления вехами для Claude Code распределяет запросы по профильным инструментам жизненного цикла разработки. CX Codex +1 573установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой