post-mortem · thananon — скилл для Claude Code: документирование багов после
Скилл пишет инженерный отчёт о найденной и исправленной ошибке: механизм, корневую причину, саму фиксу и почему баг прошёл в релиз. Используй после того, как отладка привела к рабочему исправлению и перед закрытием тикета.
npx skills add thananon/9arm-skills --skill post-mortem -a claude-codeЧто делает post-mortem
post-mortem создаёт полноценный документ о багфиксе для команды. В отчёт идут симптом, точная корневая причина с назвониями функций и путями файлов, объяснение, почему симптом связан именно с этой причиной, и описание самой фиксы. Скилл требует, чтобы репро была воспроизводимой, корневая причина понята (не гипотеза), фиксу залита и валидирована на исходном багрепорте.
Отчёт структурирован так: сводка, симптом, механизм, цепочка причинности, фиксу, путь отладки, почему баг прошёл, валидация. Каждый раздел конкретен — с именами функций, путями в коде, номерами коммитов. Скилл откажет, если чего-то из четырёх критериев не хватает: репро, известная причина, залитая фиксу, подтверждение, что исходная проблема решена.
Тон — инженер к инженеру, без смягчений. Бланелесс постмортем: описывает зазор в CI, конфигурации или ревью, но не людей. Для верхних уровней управления есть отдельный скилл, который переформатирует этот отчёт.
Какие задачи решает
- Написать инженерный отчёт о корневой причине бага с кодом и коммитами
- Задокументировать, как баг прошёл в релиз и почему тесты его не поймали
- Оставить след отладки для следующего инженера, который будет разбирать похожую проблему
- Связать видимый симптом с механизмом ошибки в коде
- Закрыть баг-тикет с полной историей фиксы и валидации
Примеры запросов агенту
- Напиши post-mortem для этого бага с корневой причиной и механизмом
- Документируй этот фикс: что ломалось, почему, как исправили, как проверили
- Составь root-cause analysis с путём отладки и тем, почему баг прошёл в мастер
Как установить post-mortem
1Через Skills CLI (Vercel)
npx skills add thananon/9arm-skills --skill post-mortem -a claude-code2Вручную: положить файлы
~/.claude/skills/post-mortem/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/post-mortem/
1Через Skills CLI (Vercel)
npx skills add thananon/9arm-skills --skill post-mortem -a codex2Вручную: положить файлы
.agents/skills/post-mortem/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add thananon/9arm-skills --skill post-mortem -a cursor2Вручную: положить файлы
.cursor/skills/post-mortem/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install thananon/9arm-skills post-mortem2Вручную: положить файлы
.github/skills/post-mortem/SKILL.md1Через Skills CLI (Vercel)
npx skills add thananon/9arm-skills --skill post-mortem -a gemini-cli2Командой платформы
gemini skills install https://github.com/thananon/9arm-skills --path skills/engineering/post-mortemВручную: положить файлы
.devin/skills/post-mortem/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add thananon/9arm-skills --skill post-mortem -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора3
Весь набор →Другие версии post-mortem
Похожие
Вопросы о post-mortem
Как установить post-mortem в Claude Code?
Запусти npx skills add thananon/9arm-skills --skill post-mortem -a claude-code, затем найди файл скилла в ~/.claude/skills/post-mortem/SKILL.md.
Что делает post-mortem?
Пишет структурированный инженерный отчёт о баге после того, как ты его отладил и исправил. В отчёт идут симптом, корневая причина с кодом, объяснение цепочки, сама фиксу, путь отладки, анализ, почему баг прошёл, и валидация исправления.
Когда использовать post-mortem и когда его не использовать?
Используй после того, как баг воспроизводим, причина известна, фиксу залита и проверена. Не используй, если баг ещё не исправлен или фиксу не валидирована, если это производственный инцидент с цепочкой алертов (для этого нужен отдельный incident report), или если фиксу тривиальная (опечатка, однострочный фикс — тогда описания в PR достаточно).
