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

pl-analyze — скилл для Claude Code: разбор инцидентов

Скилл pl-analyze для Claude Code разбирает инциденты и оценивает рабочие процессы. Запускается по запросу на ретроспективу или поиск первопричины, а также через маршрутизацию PL.

Apache-2.0 ★ 869 обновлён 2026-11-16

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

Что делает pl-analyze

Скилл восстанавливает ход инцидента по журналам на диске, временным меткам, логам выполнения и данным git, если проект его использует. Отчёты и воспоминания служат гипотезами, которые нужно сверять с записями. Если источник отсутствует в проекте, анализ его пропускает и отмечает этот факт.

Результат включает вывод, цепочку подтверждающих фактов с путями или командами, место исправления и механизм защиты от повтора. Класс причины определяет, куда попадёт исправление: например, ошибка скрипта требует правки и теста, а пробел в процессе — предложения владельцу на согласование. Анализ требует доступа к shell и чтению и записи файлов. Изменения кода вне контрольных скриптов PL передаются исполнителю; правка текста скилла проходит согласование владельца.

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

  • восстановить последовательность событий при сбое
  • сопоставить несколько ошибок и найти общий источник
  • определить место исправления по классу причины
  • зафиксировать защиту от повторения инцидента

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

  • Разбери, почему задача завершилась с ошибкой, и подготовь ретроспективу.
  • Найди первопричину остановки процесса по журналам и предложи, где исправить механизм.
  • Оцени повторяющиеся ошибки в оценках и подготовь разбор процесса.

Как установить pl-analyze

1Через Skills CLI (Vercel)

npx skills add sno-ai/sno-station-skills --skill pl-analyze -a claude-code

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

~/.claude/skills/pl-analyze/SKILL.md

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

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

Вопросы о pl-analyze

Как установить pl-analyze в Claude Code?

Выполни npx skills add sno-ai/sno-station-skills --skill pl-analyze -a claude-code. Файл скилла будет находиться по пути ~/.claude/skills/pl-analyze/SKILL.md.

Что делает pl-analyze?

Восстанавливает ход инцидента по записям на диске, классифицирует причину и связывает её с местом исправления. Результат включает доказательства и меру против повторения.

Когда запускается pl-analyze?

Скилл подключается через таблицу маршрутизации PL или по прямому запросу владельца на ретроспективу, разбор первопричины либо оценку процесса. Самостоятельно из общего контекста он не загружается.

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

SKILL.md · Apache-2.0
---
name: pl-analyze
description: "PL (Project Lead) role sub-skill for incident analysis and process evaluation. Loaded through the pl core routing table, or when the owner explicitly asks for a retrospective or root-cause write-up; NEVER auto-load from ambient context."
requires:
  programs: []
  harness:
    - {slot: 4.shell, need: required}
    - {slot: 4.file-read-write, need: required}
---

# PL · Analyze — incident analysis & process evaluation

Scripts named below run as `bash "${PL_SKILL_DIR}/scripts/<name>.sh" ...`, where `PL_SKILL_DIR` is the
absolute path of the `pl` skill directory; set it in the same Bash call. The workspace layout (`ai-doc/...`,
ledgers) is documented in the pl core's State files section; a source that does not exist in this project
is skipped and noted in the analysis.

Sub-skill of the PL role, also usable standalone. Words such as journey, callsign, night shift and
take-over are defined once, in the pl core's Terms glossary. The rules in this file are the PL role's
defaults; a project may choose otherwise.

Invoke when something went
wrong — an escaped bug, a stalled run, a run killed at its time limit, an estimate blowup, a
protocol breach, a close-audit FAIL — or when the owner ("owner" means whoever owns the work, often
the user) asks for a retrospective, a root-cause account of what went wrong, or for periodic process
evaluation (patterns in estimate errors, recurring frictions). The deliverable is never just an explanation: it is a
verified cause AND a fix landed in the right place. Core iron rules bind
unchanged; the owner is addressed in the user's own language.

## Method — evidence first, always from disk

Sessions lie and die; disk is the memory. Rebuild the timeline exclusively from:

- `sno reach log --as <your-strict-address> --work <id>` — the journey's
  full message provenance (`sno reach export --work <id> --output <path>` keeps the full
  thread bytes); command grammar is defined in
  `~/.local/lib/sno-reach/current/guide/agent-reach.md`
- `ai-doc/JOURNAL/routing-ledger.jsonl` — routed/closed/correction events (`board_closed` lines are written by `bash "${PL_SKILL_DIR}/scripts/todo.sh" close`; the PL writes the journey's own `routed`, `closed` and `correction` lines by hand)
- `ai-doc/ACTIVE/PL/exec-logs/` + dispatch files under `ai-doc/ACTIVE/PL/dispatch/`
- git log/diff of the journey's commits when the project uses git (the fence file lists the paths the journey may touch)
- the convergence series (the recorded remaining-work counts per fix cycle; `bash "${PL_SKILL_DIR}/scripts/convergence-watch.sh" verdict --journey <id>`)
- `~/.local/state/agent-spawns.jsonl` + `agent-callsigns.jsonl` + tmux autopsy
  (an executor killed at its time limit leaves its session up — read the screen)

Reports, memories, and your own recollection are HYPOTHESES to check against
this record, never evidence. Timestamp every step; a contradiction between two
sources is a finding, not noise. N different-looking failures arriving together
get ONE joined timeline BEFORE any is diagnosed separately — join the
timestamps in the target machine's system log first; cascades collapse into
one root event and red herrings die at the join — several apparently separate
failures are often one shared cause. A status table built from disk beats a report built from a
stale card — trust the freshest disk join, not the most confident narrator.

## Root-cause classification → fix location

The class DECIDES where the fix lands — never write a note where a mechanism
belongs:

| Class | Signature | Fix lands in |
|---|---|---|
| Machinery bug | a script/skill deterministically did the wrong thing | the skill CODE (script fix + test), then reinstalled |
| Judgment lapse | the agent saw the signal and chose wrong / waited on a human | MECHANIZE it — an alarm/verdict/gate in scripts (e.g. a stalled-close alarm); a memory note is NOT a fix |
| Estimation error | estimate vs actual > 2× | the est/actual pair → calibration material for `agentic-time-estimate` (when installed; otherwise a plain note of the pair) |
| Knowledge trap | a known trap, hit again | the lessons file `ai-doc/LESSONS.md` (written only by the PL; a trap enters the index on its SECOND hit — see the pl core, Lessons file) |
| Process gap | no rule existed for the situation | retro proposal → owner approval → skill text patch (never self-edited mid-journey) |

Design principle: **the machine must lose patience before the owner
does** — every place the owner had to scold marks a missing mechanical control;
an analysis is not done until that control is named (or shown to already exist).

## Output shape

Owner-facing report, written in the user's own language, four sections: (1) conclusion — what broke, one line;
(2) evidence chain — the 2–4 load-bearing facts, each with its path/command;
(3) where the fix lands — the fix and its location per the table above; (4) recurrence prevention — the
check/alarm/rule that now exists. Agent-facing: the same content as an English
postmortem section in the journey's journal entry, plus ledger `correction` events
wherever the durable record was wrong.

## Routing the lessons

A finished analysis routes each lesson to the file that OWNS the behavior:
dispatch-time rules → `pl-dispatch`; in-flight controls and alarms →
`pl-watch`; close/probe rules → `pl-audit`; environment checks → `pl-env`;
board/memory/Reach-substrate law → the `pl` core. A lesson without a named
owner file is not landed.

## Boundaries

- Script/machinery fixes land directly ONLY within the core iron-rule-1
  exception: PL-owned control scripts under the pl skill's `scripts/`,
  with a test, then reinstalled and reported to the owner. Anything else that needs code —
  repo source, other skills' scripts — is dispatched to an executor, never
  hand-edited. SKILL text changes still ride the retro → owner-approval path
  (core boundary).
- Estimation analysis only FILES the calibration pair — rate/multiplier changes
  belong to the estimator skill's own validation loop (when installed).
- Analysis of a journey never reopens settled owner rulings; if the cause traces
  to a ruling, report the trace, don't relitigate.

© sno-ai · Apache-2.0 · sno-ai/sno-station-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
project-retrospective jamditis Скилл project-retrospective генерирует LESSONS.md файлы, которые фиксируют знания и ошибки проекта. Пригодится при закрытии проекта или расследования, чтобы не потерять выводы и не повторить ошибки. CX Codex +1 189установок root-cause-analysis autohandai Скилл root-cause-analysis исследует инциденты, регрессии и повторяющиеся сбои, чтобы найти причину в устройстве системы. Помогает подготовить постмортем с хронологией событий и мерами профилактики. CX Codex +1 ★ 219звёзд репо postmortem-aggregator Riccardo Carlesso Скилл postmortem-aggregator для Claude Code разбирает Post Mortem в папке, рассчитывает показатели сбоев и обновляет POMO_AGGREGATED.md. Помогает находить повторяющиеся причины инцидентов. CX Codex +1 ★ 151звёзд репо five-whys ysskrishna Скилл five-whys для Claude Code разбирает сбои методом «Пять почему» и проверяет причинную цепочку по свидетельствам. Запускается по запросу найти корень повторяющейся ошибки или подготовить постмортем. CX Codex +1 ★ 25звёзд репо post-mortem thananon Скилл post-mortem пишет инженерный отчёт о найденной и исправленной ошибке: механизм, корневую причину, саму фиксу и почему баг прошёл в релиз. Используй после того, как отладка привела к рабочему исправлению и перед закрытием тикета. CX Codex +1 4 900установок postmortem Alireza Rezvani Скилл postmortem проводит разбор неудач по методу «5 почему» и фиксирует изменения с ответственными. Пригодится после сорванного запуска, провала функции или неудачного найма. CX Codex +1 1 465установок

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

Весь набор →
pl-watch Скилл pl-watch для Claude Code помогает PL следить за исполнителями, которые уже выполняют задачи. Его подключает основной скилл PL при новых карточках, остановках и других событиях работы. CX Codex +1 ★ 869звёзд репо pl-env Скилл pl-env для Claude Code проверяет окружение проекта и помогает разбирать блокеры перед запуском тестов или работы с VM. Скилл подключает только основной pl по своей таблице маршрутизации. CX Codex +1 ★ 869звёзд репо pl-dispatch Скилл pl-dispatch для Claude Code помогает Project Lead открыть рабочий маршрут и составить план его запуска. Его подключает скилл pl по таблице маршрутизации, когда нужно распределить работу или решить, что запускать дальше. CX Codex +1 ★ 869звёзд репо pl-audit Скилл pl-audit для Claude Code проверяет отчёты исполнителей и закрытие задач. Его подключает скилл pl через свою таблицу маршрутизации, когда приходит отчёт или сигнал закрытия. CX Codex +1 ★ 869звёзд репо cos Координирует владельца проекта и руководителей отдельных проектов. Активируется по команде /cos, $cos или прямой просьбе взять роль Chief of Staff. CX Codex +1 ★ 869звёзд репо cos-watch Скилл cos-watch для Claude Code следит за активными PL: проверяет их состояние, пробуждения и ход задач. Его загружает только ядро COS через таблицу маршрутизации, когда работа уже идёт. CX Codex +1 ★ 869звёзд репо cos-review Скилл cos-review для Claude Code проверяет решения, закрытия и оценки после объявленной ночной смены. Его загружает COS core через таблицу маршрутизации, когда владелец возвращается или закрывается пакет задач. CX Codex +1 ★ 869звёзд репо cos-evolve Скилл cos-evolve для Claude Code превращает повторяющиеся управленческие ошибки в правила для COS или PL. COS подключает его после активации роли владельцем сессии. CX Codex +1 ★ 869звёзд репо

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

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