Přeskočit na obsah

/diagnose — Diagnostika prostředí

Diagnostika prostředí: Zjistí, jestli má prostředí šanci fungovat: git a větev, worktree a souběžné session, Node, npm, Zola, závislosti, nastavení git hooků, přítomnost vygenerovaných vstupů, stav co-op a načtení konfigurace .claude/. Claude skill, kontrola výstupů.

Claude skill kontrola výstupů

Volání

/diagnose

Argumenty: "[volitelně: co konkrétně nefunguje]"

Zdroj: .claude/skills/diagnose/SKILL.md

Zjistí, jestli má prostředí šanci fungovat: git a větev, worktree a souběžné session, Node, npm, Zola, závislosti, nastavení git hooků, přítomnost vygenerovaných vstupů, stav co-op a načtení konfigurace .claude/. Každé zjištění zařadí jako PASS, WARN nebo FAIL a přiloží konkrétní opravu. Sám neopravuje nic — diagnostikovat a opravit jsou dva různé úkony.

Kdy ho spustit

Po naklonování repozitáře nebo založení worktree, a kdykoli něco nejde spustit nebo build padá na něčem, co nevypadá jako chyba v datech.

Pro koho a s jakým rizikem

  • Persona: čtenář, ověřovatel, přispěvatel zdrojem, rešeršista, editor, vývojář, recenzent, údržbář, orchestrátor
  • Riziko: jen čte
  • Zapisuje do souborů: ne

Co vynucuje

Nic — tenhle příkaz reportuje nebo generuje, ale sám o sobě nic neshazuje. Co selže při chybě, hlídají brány, které za ním v pipeline běží.

Co je potřeba vědět

  • Jmenuje se diagnose, a ne doctor, protože /doctor je vestavěný příkaz Claude Code a projektový skill toho jména by v interaktivní session nešlo spustit.
  • Nejčastější skutečný nález je nový worktree: chybí v něm node_modules i vygenerované soubory a pre-commit na tom spadne dřív, než se stihne podivit. Pořadí opravy je npm ci, pak npm run generate:all.
  • Chybějící Zola je FAIL jen částečný — datové validátory i generátory poběží, spadne až zola build. Hlásí se to takhle přesně, protože „build nefunguje“ by poslalo člověka hledat chybu jinam.
  • Když všechno projde, výstup je jeden řádek. Diagnostika, která i při zdravém prostředí vypíše třicet řádků, se přestane číst.

Jak se skill popisuje sám

Zkontroluje, jestli je prostředí schopné v tomhle repozitáři pracovat — git, worktree, Node, Zola, závislosti, git hooky, vygenerované soubory, stav co-op a dostupnost brány kvality. Použij ho, když něco nejde spustit, build padá na něčem, co nevypadá jako chyba v datech, po prvním naklonování repozitáře, nebo když uživatel řekne „nefunguje mi to", „nejde build", „chybí mi něco".

Doslovný text z .claude/skills/diagnose/SKILL.md.

Vstupy a výstupy

Čte

  • .claude/settings.json
  • .claude/skills
  • scripts/build/require-generated.mjs
  • scripts/coop/coop.sh

Popis vychází z hlavičkového komentáře zdrojového souboru. Volání, zařazení do pipeline i členství v pre-commit hooku se dopočítávají při každém buildu ze samotného repozitáře.