BlockWatch
Verklig Rust-linter som fångar kod/dokument-drift via <block affects=...> kommentarstagg - verifierad med den faktiska kompilerade binären, inte bara genom att läsa källkoden.
Testad · Fungerar
Vad den gör
En språgoberoende linter (Rust CLI, installerbar via cargo eller brew) som validerar HTML-liknande <block>-taggar placerade i källfilskommentarer: keep-sorted/keep-unique-listor, radmönster/radantal-begränsningar och affects-länkar som tvingar en parad fil (t.ex. en enum och dess README-tabell) att ändras tillsammans. Utlöses vid skrivning eller redigering av kod i ett projekt som redan använder BlockWatch, eller när en fil redan innehåller <block ...>-taggar; färdigheten instruerar agenten att lägga till taggar i samma redigering som introducerar ett skyddsbart mönster och att verifiera med `git diff --patch | blockwatch`.
Testrapport
Installerade den verkliga binären via `brew install mennanov/blockwatch/blockwatch` (betrodd formel, byggd på 1s) och körde en fullständig A/B i ett engångs git-repo: en naiv baslinjeredigering lade till ett språk i en Python-lista men glömde tyst motsvarande README-rad utan varning, medan den färdighetsledda redigeringen lade till `<block affects=...>`-taggar i samma ändring, höll båda filerna synkroniserade, klarade `git diff --patch | blockwatch` (exit 0), och fångade sedan korrekt en uppföljande naiv redigering med ett exakt 'is modified, but README.md:supported-langs is not' brott (exit 1) -- men SKILL.md:s påstående att bara `blockwatch` (ingen diff pipad) 'validerar varje block i trädet' är falskt, verifierat empiriskt: med en osorterad keep-sorted-lista och ingen diff på stdin avslutas den tyst med 0, vilket motsäger verktygets egen --help-text och dess egen mening 'only validated when touched by a diff' någon annanstans i samma fil.
Testad: 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
Kommandon och exempelprompter
/blockwatchVerklig Rust-linter som fångar kod/dokument-drift via <block affects=...> kommentarstagg - verifierad med den faktiska kompilerade binären, inte bara genom att läsa källkoden.
Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):
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