Skills Agentes

Rule Research

Define un contrato preciso de regla de React Doctor antes de implementarla. Se usa al validar la idea de una regla, recoger evidencia, identificar trampas de falso positivo o fijar los límites de la primera versión.

Estrellas
14.7k

en todo el repo

Actividad
54

0–100, la ruta de este skill

Actualizado
el mes pasado

último commit aquí

Commits
1

últimos 90 días

Contexto
566 tok

61 tok en reposo

Paquete
1 archivo

2 KB

Instalar

Funciona con cualquier agente que lea SKILL.md

npx -y skills add millionco/react-doctor --skill rule-research --agent claude-code

Se instala solo en este repositorio.

Qué hace

  • Define un contrato preciso de regla de React Doctor antes de implementarla, que `rule-writing` pueda implementar sin adivinar.
  • Resuelve solo lo que afecta a la corrección: qué patrón debe reportar, qué comportamiento en runtime lo hace dañino, qué código parecido debe quedarse callado y qué análisis necesita la detección.
  • Reúne evidencia: define la regla en una frase, explica el motivo en runtime, inspecciona reglas y utilidades cercanas y usa `truffler` antes de proponer un detector o helper nuevo.
  • Separa positivos fuertes, patrones adyacentes, trampas válidas y casos no soportados, y elige detección solo-sintaxis, con scope o con paths.
  • Devuelve un contrato con secciones fijas (definición, motivo, precisión del detector, evidencia, positivos, trampas de falso positivo, en/ fuera de scope, semillas de test, preguntas abiertas).

Úsalo cuando

  • Al validar la idea de una regla, recoger evidencia oficial o de código abierto, identificar trampas de falso positivo o fijar los límites de la primera versión.

No lo uses cuando

    Qué lo activa

    Di cualquiera de estas frases y el agente debería cargar este skill.

    • Investiga el contrato para una regla que detecte setState dentro de useFrame
    • ¿Qué trampas de falso positivo tiene esta idea de regla?
    • Define los límites de la primera versión de esta regla

    SKILL.md

    En inglés

    Research a rule

    Produce a rule contract that rule-writing can implement without guessing.

    Define the behavior

    Resolve only questions that affect correctness:

    • Which code pattern should report?
    • Which runtime behavior makes it harmful?
    • Which similar code must stay quiet?
    • Does detection need syntax, scope, or path analysis?
    • Which imported, dynamic, type-driven, or interprocedural cases stay out of scope?

    If the user requested implementation, make the contract concise and continue.

    Collect evidence

    1. Define the rule in one sentence: This rule catches <pattern> that causes <problem>.

    2. Explain the runtime reason.

    3. Inspect nearby rules, tests, utilities, and the generated registry.

    4. Use truffler before proposing a new detector or helper:

      bunx @rayhanadev/truffler "<symbol-or-behavior>" \
        packages/oxlint-plugin-react-doctor/src/plugin \
        --kind function,interface,type,constant --limit 20
      
    5. Gather official documentation, implementation notes, related linter behavior, and open-source examples.

    6. Separate strong positives, adjacent patterns, valid traps, and unsupported cases.

    7. Choose syntax-only, scope-aware, or path-aware detection.

    Use rde-eval when a bounded open-source sample could change the contract. Leave final pull request parity to rule-validate.

    Write the contract

    Return:

    Rule definition:
    <pattern and specific problem>
    
    Runtime reason:
    <short explanation>
    
    Detector precision:
    <syntax-only, scope-aware, or path-aware>
    
    Evidence:
    
    - <source and implication>
    
    Strong positives:
    
    - <reportable examples>
    
    False-positive traps:
    
    - <valid examples>
    
    In scope:
    
    - <supported cases>
    
    Out of scope:
    
    - <explicit boundaries>
    
    Test seeds:
    
    - <invalid and valid fixtures>
    
    Open questions:
    
    - <correctness blockers only>
    

    Treat false positives as correctness bugs. Keep the diagnostic narrower than or equal to the proven behavior. Split adjacent ideas into separate rules.

    Reproducido de millionco/react-doctor bajo licencia NOASSERTION. Leer esta página en markdown.

    Archivos

    1 archivo en el paquete. Solo se lee SKILL.md al activarse — las referencias se cargan si el skill decide que las necesita.

    Detalles

    Creador
    millionco
    Licencia
    NOASSERTION
    Recursos incluidos
    Solo SKILL.md
    Código fuente
    Ver SKILL.md

    Etiquetas

    Más de millionco/react-doctor

    Este repo incluye 16 skills. Si instalas uno, normalmente ya tienes los demás.

    Escanea bases de código React en busca de problemas de seguridad, rendimiento, corrección y arquitectura, y da una puntuación de salud de 0 a 100. Incluye chequeo de regresión y un flujo completo de triage local con `/doctor`.

    Costo de contexto al activarse
    1k tok
    Tamaño del paquete
    2 archivos
    Última actualización
    hace 15 días
    testing qa

    Compara los diagnósticos de React Doctor de un pull request contra su base con Daytona. Se usa para correr parity, comprobar regresiones de diagnósticos en un PR o reportar diagnósticos añadidos y quitados.

    Costo de contexto al activarse
    4.1k tok
    Tamaño del paquete
    17 archivos
    Última actualización
    hace 28 días
    testing qa

    Audita y arregla apps de Three.js y React Three Fiber: rendimiento del frame-loop, fugas de memoria de GPU, corrección del grafo de escena y defectos visuales como z-fighting, shadow acne, espacio de color erróneo y resize roto.

    Costo de contexto al activarse
    2.3k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 15 días
    herramientas desarrollo

    Fuzz

    14.7k

    Somete a fuzzing las reglas de React Doctor con `@react-doctor/fuzz` para hallar crashes, lentitud, falsos positivos y diagnósticos sensibles a mutaciones. Se usa tras pasar los tests de la regla o al confirmarse un falso positivo nuevo.

    Costo de contexto al activarse
    839 tok
    Tamaño del paquete
    1 archivo
    Última actualización
    el mes pasado
    testing qa

    Diagnostica el rendimiento de React en tiempo de ejecución con trazas de React Doctor, marcado de renders en vivo, Long Animation Frames y evidencia de renders por componente. Se invoca como `/performance`.

    Costo de contexto al activarse
    1.2k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 15 días
    testing qa

    Audita React Doctor contra corpus de benchmark como ReactBench: falsos positivos y negativos confirmados, huecos de taxonomía y artefactos del verificador. Se usa al analizar logs y artefactos de trial o al pedir un segundo pase.

    Costo de contexto al activarse
    2k tok
    Tamaño del paquete
    3 archivos
    Última actualización
    el mes pasado
    testing qa

    Skills relacionados

    Deslop

    14.7k

    Simplifica y refina el código modificado hace poco preservando la funcionalidad. Se activa con "deslop", "limpiar el código", "simplificar el código" o tras cambios que se beneficiarían de un refinado.

    Costo de contexto al activarse
    1.2k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 3 meses
    herramientas desarrollo

    Usa truffler para encontrar símbolos JS/TS parecidos o ya existentes antes de implementar código nuevo, sobre todo helpers, utilidades, parsers, formatters, scanners y fuzzy matchers, para no duplicar código existente.

    Costo de contexto al activarse
    1.2k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 3 meses
    herramientas desarrollo

    Audita toda una base de código React como ingeniero sénior, apoyándose en el escaneo de React Doctor, y produce hallazgos priorizados y planes de implementación autocontenidos. Es de solo lectura: planifica mejoras, no las aplica.

    Costo de contexto al activarse
    3.1k tok
    Tamaño del paquete
    3 archivos
    Última actualización
    el mes pasado
    herramientas desarrollo