BlockWatch
Reel Rust linter, der fanger kode/dokumentations-drift via <block affects=...> kommentar-tags -- verificeret med den faktiske byggede binære fil, ikke kun læsning af kildekoden.
Testet · Virker
Hvad det gør
En sprog-agnostisk linter (Rust CLI, kan installeres via cargo eller brew), der validerer HTML-lignende <block> tags placeret i kildekode-kommentarer: keep-sorted/keep-unique lister, line-pattern/line-count begrænsninger og affects links, der tvinger en parret fil (f.eks. en enum og dens README-tabel) til at ændre sig sammen. Udløses ved skrivning eller redigering af kode i et projekt, der allerede bruger BlockWatch, eller når en fil allerede indeholder <block ...> tags; færdigheden fortæller agenten at tilføje tags i den samme redigering, der introducerer et beskytteligt mønster, og at verificere med `git diff --patch | blockwatch`.
Testrapport
Installerede den rigtige binære fil via `brew install mennanov/blockwatch/blockwatch` (betroet formel, bygget på 1s) og kørte en fuld A/B i et engangs git-repo: en naiv baseline-redigering tilføjede et sprog til en Python-liste, men glemte tavst den matchende README-linje uden advarsel, mens den færdigheds-guidede redigering tilføjede `<block affects=...>` tags i den samme ændring, holdt begge filer synkroniserede, passerede `git diff --patch | blockwatch` (exit 0), og fangede derefter korrekt en efterfølgende naiv redigering med en præcis 'is modified, but README.md:supported-langs is not' overtrædelse (exit 1) -- men SKILL.md's påstand om, at bar `blockwatch` (ingen diff pipet) 'validerer hver blok i træet' er falsk, verificeret empirisk: med en usorteret keep-sorted liste og ingen diff på stdin afsluttes den tavst med 0, hvilket modsiger værktøjets egen --help tekst og dens egen 'kun valideret, når den berøres af en diff'-sætning andre steder i samme fil.
Testet: 2026-07-15 · Claude Code 2.x (agent harness)
Installation
git clone https://github.com/mennanov/blockwatch cd blockwatch mkdir -p ~/.claude/skills cp -r .agents/skills/blockwatch ~/.claude/skills/blockwatch
Kommandoer og eksempelprompter
/blockwatchReel Rust linter, der fanger kode/dokumentations-drift via <block affects=...> kommentar-tags -- verificeret med den faktiske byggede binære fil, ikke kun læsning af kildekoden.
Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):
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