Communitygithub.com

Al0olo/Agents-village

Diseña, pre-registra, ejecuta o analiza un experimento (RQ1, RQ2, RQ3). Úsalo al redactar un pre-registro, elegir brazos, medidas, tamaño de muestra o estadísticas, plantar hechos o interpretar resultados.

¿Qué es Agents-village?

Este skill guía al usuario a través del diseño, pre-registro, ejecución y análisis de experimentos con agentes en un entorno de 'aldea' (village). Está estructurado en torno a tres preguntas de investigación (RQ1, RQ2, RQ3), siendo RQ1 la principal y las otras dos diferidas. Proporciona una lista de verificación detallada para el pre-registro que cubre hipótesis, brazos experimentales, medidas, modelos, hechos plantados, controles y reglas de exclusión, asegurando que cada paso se documente antes de la primera ejecución. También incluye recordatorios estadísticos sobre límites de potencia con diseños pequeños y el uso correcto de R0, así como un procedimiento paso a paso que va desde la redacción del pre-registro hasta el análisis final y la actualización del documento de traspaso. Es ideal para investigadores que realizan experimentos controlados con múltiples brazos y necesitan transparencia y reproducibilidad.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Al0olo/Agents-village/tree/HEAD/.claude/skills/experiment-design

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Diseño de experimentos

Lee primero la sección 1 de docs/prd.md. RQ1 es la principal; RQ2 y RQ3 están diferidas.

Lista de verificación de pre-registro (confirmar antes de la primera ejecución)

  • Pregunta, hipótesis y el resultado que la refutaría.
  • Brazos y el contraste principal (RQ1: admisión del kernel contra el mejor brazo prompt).
  • La aldea base se ejecuta sin defensa hasta la bifurcación (ADR-0003); reporta la proporción de entradas centrales y compartidas en la bifurcación que la regla del kernel habría rechazado.
  • Unidad de análisis: la aldea o el bloque emparejado. Bloques, bifurcaciones y su número, con el piloto que lo establece.
  • Medidas, cómo se codifica cada una, quién o qué las codifica (juez ciego más muestra validada por humanos).
  • Mix de modelos, IDs de instantáneas fijadas, proveedor enrutado, fallbacks desactivados, brazos lanzados juntos.
  • Hechos plantados: solo entidades ficticias, plausibilidad y estado del plantador contrabalanceados.
  • Los brazos exploratorios (por ejemplo, F, memoria estándar) se etiquetan como exploratorios, excluidos del contraste principal y de la corrección de multiplicidad.
  • Controles: sonda de conciencia, control de paráfrasis de prompt, control de bloques aleatorios emparejados por volumen.
  • Reglas de exclusión para aldeas bloqueadas, regla de parada, plan para modelos obsoletos.
  • Análisis: diferencias intrapares dentro de bloques, tamaños de efecto con intervalos, corrección para comparaciones múltiples, estimación de potencia y cómo se recalculará a partir del piloto.
  • Condiciones de apoyo y refutación escritas de antemano.

Recordatorios estadísticos

  • El piso de la prueba de permutación exacta es aproximadamente 0.029 con 4 por brazo, 0.10 con 3 por brazo, por lo que los diseños pequeños no emparejados no pueden alcanzar significación. Las bifurcaciones emparejadas son la herramienta de potencia.
  • R0 no está definido con 7 susceptibles a resolución diaria; no lo uses.
  • Reporta resultados negativos.

Procedimiento

  1. Redacta experiments/<rq>/PREREGISTRATION.md a partir de la lista de verificación; obtén la revisión del propietario.
  2. Ejecuta el piloto de 2 bloques; registra la varianza, la correlación de bifurcaciones, la fiabilidad de codificación, el costo por ciudadano-día.
  3. Congela las configuraciones (fijadas por hash), registra en OSF, luego ejecuta.
  4. Analiza exactamente como se registró; coloca las desviaciones en una enmienda fechada.
  5. Actualiza docs/HANDOFF.md.

Skills relacionados