Code Reader v2 (English)

Análisis de código 'WHY-first' con alternativas rechazadas y condiciones de contorno

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

Probado · Funciona ★ 8.0/10

Code Reader v2 (English) — Análisis de código 'WHY-first' con alternativas rechazadas y condiciones de contorno

Qué hace

Una habilidad de comprensión de código basada en la ciencia cognitiva con tres niveles de profundidad — Rápido, Estándar y Profundo — que hacen que el análisis responda por qué el código está construido de esta manera, qué alternativas fueron rechazadas y dónde deja de funcionar. Se activa con "analyze this", "help me understand", "explain the principle" o "deep dive". Sus secciones obligatorias de alternativas y escenarios inaplicables revelan invariantes de diseño que un resumen de archivo simple omite.

Informe de la prueba

Analicé un archivo real — el redactor de 8 regex en lib/redact.ts de Prompt Sensei — en frío y luego en modo Estándar, y verifiqué cada afirmación ejecutando el código. Mi resumen en frío enumeró los patrones y dijo que se aplicaban en secuencia; nunca señaló que la secuencia es fundamental. Las secciones obligatorias de la habilidad "por qué no otros enfoques" y "escenarios inaplicables" produjeron dos hallazgos que luego confirmé mediante la ejecución: mover el comodín [SECRET] de más de 40 caracteres al principio del array hizo que un JWT filtrara su encabezado y carga útil en texto plano (eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0. sobrevivió, solo la firma fue enmascarada) en lugar de ser completamente reemplazado por [TOKEN], y ese mismo comodín dio falsos positivos en un SHA de git de 40 caracteres hexadecimales y un nombre de archivo de caché largo de node_modules. El costo es una verdadera hinchazón: un SKILL.md de 722 líneas y 28 KB de plantillas para lo que a menudo es una pregunta de un solo archivo. La documentación también se excede — las duraciones son aspiracionales, "code review" se enumera como un disparador para lo que es una herramienta de comprensión en lugar de un buscador de errores, y el archivo .skill zip incluido es un duplicado no documentado del mismo contenido.

Probado el: 2026-07-17 · Claude Code 2.x (agent harness)

Instalación

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

Comandos y prompts de ejemplo

  • /code-reader-v2-enAnálisis de código 'WHY-first' con alternativas rechazadas y condiciones de contorno

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • 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