BlockWatch
Skutečný Rust linter, který zachytává drift kódu/dokumentace pomocí komentářových tagů <block affects=...> -- ověřeno skutečným sestaveným binárním souborem, nejen čtením zdrojového kódu.
Otestováno · Funguje
Co umí
Jazykově agnostický linter (Rust CLI, instalovatelný přes cargo nebo brew), který validuje HTML-podobné tagy <block> umístěné v komentářích zdrojových souborů: seznamy keep-sorted/keep-unique, omezení vzorů řádků/počtu řádků a odkazy affects, které nutí spárovaný soubor (např. enum a jeho README tabulku) měnit se společně. Spouští se při psaní nebo úpravě kódu v projektu, který již BlockWatch používá, nebo když soubor již obsahuje tagy <block ...>; skill instruuje agenta, aby přidal tagy ve stejné úpravě, která zavádí chráněný vzor, a aby ověřil pomocí `git diff --patch | blockwatch`.
Testovací report
Nainstaloval skutečný binární soubor přes `brew install mennanov/blockwatch/blockwatch` (důvěryhodný vzorec, sestaveno za 1s) a provedl plný A/B test v jednorázovém git repozitáři: naivní základní úprava přidala jazyk do Python seznamu, ale tiše zapomněla odpovídající řádek README bez varování, zatímco úprava řízená skillem přidala tagy `<block affects=...>` ve stejné změně, udržovala oba soubory synchronizované, prošla `git diff --patch | blockwatch` (exit 0) a poté správně zachytila následnou naivní úpravu s přesným porušením 'is modified, but README.md:supported-langs is not' (exit 1) -- ale tvrzení SKILL.md, že holé `blockwatch` (bez pipovaného diffu) 'validuje každý blok ve stromu', je nepravdivé, empiricky ověřeno: s nesetříděným seznamem keep-sorted a bez diffu na stdin tiše ukončuje s kódem 0, což je v rozporu s textem --help samotného nástroje a jeho vlastním větou 'only validated when touched by a diff' jinde ve stejném souboru.
Testováno: 2026-07-15 · Claude Code 2.x (agent harness)
Instalace
git clone https://github.com/mennanov/blockwatch cd blockwatch mkdir -p ~/.claude/skills cp -r .agents/skills/blockwatch ~/.claude/skills/blockwatch
Příkazy a ukázkové prompty
/blockwatchSkutečný Rust linter, který zachytává drift kódu/dokumentace pomocí komentářových tagů <block affects=...> -- ověřeno skutečným sestaveným binárním souborem, nejen čtením zdrojového kódu.
Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):
Add a block tag so this Python list stays in sync with README docsI added a new item to this enum, check if the docs need updating tooVerify my code changes with blockwatch before I commit this diff