Přeskočit na obsah

/review-gap — Review mezery

Review mezery: Sedmi kontrolami posoudí, jestli je zapsaná mezera skutečně otevřenou otázkou, a ne skrytou spekulací. Claude skill, kontrola výstupů.

Claude skill kontrola výstupů

Volání

/review-gap

Argumenty: "<GAP-## [slug dossieru]> nebo text mezery"

Zdroj: .claude/skills/review-gap/SKILL.md

Sedmi kontrolami posoudí, jestli je zapsaná mezera skutečně otevřenou otázkou, a ne skrytou spekulací. Rozhodující je test čtenáře, který o věci nic neví: co si odnese, kdyby mezeru nikdo nikdy nedoplnil. Dobrá mezera po sobě nechá prázdné místo, ne stín — a řekne, co konkrétně chybí ve zdrojích, místo aby naznačila, co si má čtenář domyslet.

Kdy ho spustit

Před zápisem nové mezery, při revizi dossieru, a když někdo namítne, že formulace mezery něco naznačuje.

Pro koho a s jakým rizikem

  • Persona: ověřovatel, editor, recenzent, údržbář
  • 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

  • Mezera je nejcitlivější typ záznamu: na tvrzení je vidět, že je tvrzení, ale mezera vypadá jako poctivé přiznání neznalosti — a proto se do ní dá schovat obvinění, které by jako tvrzení neprošlo.
  • Skill nerozhoduje, jestli má mezera vzniknout. Vzniknout má vždy, když zdroje na otázku neodpovídají; kontroluje se, JAK je napsaná.
  • U nálezu BLOCKER je návrh nového znění povinný. U mezery, která zavádí téma bez jediného zdroje, je správný návrh žádný — má zaniknout.

Jak se skill popisuje sám

Zkontroluje, jestli je zapsaná mezera (GAP) skutečně otevřenou otázkou, a ne skrytou spekulací nebo náznakem obvinění bez důkazu. Použij ho při revizi dossieru, před zápisem nové mezery, nebo když někdo namítne, že GAP „něco naznačuje".

Doslovný text z .claude/skills/review-gap/SKILL.md.

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.