Code Reader v2 (English)

WHY-first code-analyse met afgewezen alternatieven en randvoorwaarden

Door notlate-cn · notlate-cn/code-reader-skills

Getest · Werkt ★ 8.0/10

Code Reader v2 (English) — WHY-first code-analyse met afgewezen alternatieven en randvoorwaarden

Wat het doet

Een op cognitieve wetenschap gebaseerde codebegrip skill met drie dieptes — Quick, Standard en Deep — die de analyse laten beantwoorden waarom de code op deze manier is gebouwd, welke alternatieven zijn afgewezen en waar het stopt met werken. Activeert bij "analyze this", "help me understand", "explain the principle" of "deep dive". De verplichte alternatieven en inapplicable-scenarios secties brengen ontwerpinvarianten naar boven die een simpele bestandssamenvatting overslaat.

Testrapport

Een echt bestand geanalyseerd — de 8-regex redactor in Prompt Sensei's lib/redact.ts — koud en vervolgens in Standard modus, en elke claim geverifieerd door de code uit te voeren. Mijn koude samenvatting vermeldde de patronen en zei dat ze sequentieel werden toegepast; het gaf nooit aan dat de sequentie dragend is. De verplichte "why not other approaches" en "inapplicable scenarios" secties van de skill produceerden twee bevindingen die ik vervolgens door uitvoering bevestigde: het verplaatsen van de 40-plus-karakter [SECRET] catch-all naar het begin van de array zorgde ervoor dat een JWT zijn header en payload in platte tekst lekte (eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0. overleefde, alleen de handtekening werd gemaskeerd) in plaats van volledig te worden vervangen door [TOKEN], en diezelfde catch-all gaf false-positives op een 40-hex git SHA en een lange node_modules cache bestandsnaam. De kosten zijn echte bloat: een 722-regelige, 28KB SKILL.md van templates voor wat vaak een één-bestandsvraag is. Docs reiken ook te ver — de duur is aspiratief, "code review" wordt vermeld als een trigger voor wat een begripstool is in plaats van een bugfinder, en de gebundelde .skill zip is een ongedocumenteerde duplicaat van dezelfde inhoud.

Getest op: 2026-07-17 · Claude Code 2.x (agent harness)

Installatie

git clone https://github.com/notlate-cn/code-reader-skills.git
mkdir -p ~/.claude/skills
cd code-reader-skills && cp -r code-reader-en ~/.claude/skills/code-reader-v2-en

Commando's en voorbeeldprompts

  • /code-reader-v2-enWHY-first code-analyse met afgewezen alternatieven en randvoorwaarden

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

  • Explain why this redactor code is built this way, not just what it does
  • What alternatives did this function reject, and where does it break
  • Deep dive into this module's design invariants and boundary conditions