BlockWatch

Ekte Rust linter som fanger kode/dokumentasjonsdrift via <block affects=...> kommentar-tagger -- verifisert med den faktiske bygde binærfilen, ikke bare ved å lese kildekoden.

av mennanov · mennanov/blockwatch

Bestått ★ 9.2/10

BlockWatch — Ekte Rust linter som fanger kode/dokumentasjonsdrift via <block affects=...> kommentar-tagger -- verifisert med den faktiske bygde binærfilen, ikke bare ved å lese kildekoden.

Hva den gjør

En språk-agnostisk linter (Rust CLI, kan installeres via cargo eller brew) som validerer HTML-lignende <block> tagger plassert i kildekodekommentarer: keep-sorted/keep-unique lister, linjemønster/linjeantall begrensninger, og affects lenker som tvinger en paret fil (f.eks. en enum og dens README-tabell) til å endres sammen. Utløses ved skriving eller redigering av kode i et prosjekt som allerede bruker BlockWatch, eller når en fil allerede inneholder <block ...> tagger; ferdigheten instruerer agenten til å legge til tagger i samme redigering som introduserer et guardbart mønster og til å verifisere med `git diff --patch | blockwatch`.

Testrapport

Installerte den ekte binærfilen via `brew install mennanov/blockwatch/blockwatch` (betrodd formel, bygget på 1s) og kjørte en full A/B i et engangs git repo: en naiv grunnlinjeredigering la til et språk i en Python-liste, men glemte stille den tilsvarende README-linjen uten advarsel, mens den ferdighetsguidede redigeringen la til `<block affects=...>` tagger i samme endring, holdt begge filene synkronisert, passerte `git diff --patch | blockwatch` (exit 0), og fanget deretter korrekt en oppfølgende naiv redigering med en presis 'er modifisert, men README.md:supported-langs er ikke' overtredelse (exit 1) - men SKILL.mds påstand om at bare `blockwatch` (ingen diff pipet) 'validerer hver blokk i treet' er usann, verifisert empirisk: med en usortert keep-sorted liste og ingen diff på stdin, avsluttes den stille med 0, i strid med verktøyets egen --help tekst og dens egen 'kun validert når berørt av en diff'-setning andre steder i samme fil.

Testet på: 2026-07-15 · Claude Code 2.x (agent harness)

Installer

git clone https://github.com/mennanov/blockwatch
cd blockwatch
mkdir -p ~/.claude/skills
cp -r .agents/skills/blockwatch ~/.claude/skills/blockwatch

Kommandoer og eksempelprompter

  • /blockwatchEkte Rust linter som fanger kode/dokumentasjonsdrift via <block affects=...> kommentar-tagger -- verifisert med den faktiske bygde binærfilen, ikke bare ved å lese kildekoden.

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

  • Add a block tag so this Python list stays in sync with README docs
  • I added a new item to this enum, check if the docs need updating too
  • Verify my code changes with blockwatch before I commit this diff