Saltar al contenido
KendorDocs

Envía tu primera prueba de código

Para propietarios y editores ·

Crea una prueba de código a partir de tu propio repositorio, comprueba que funciona e invita a un candidato. Unos 15 minutos.

Antes de empezar

  • Una organización de Kendor. El acceso es bajo petición: escribe en el formulario de contacto y recibirás un enlace para configurarla.
  • El rol de Propietario o de Editor. Los observadores pueden leer pruebas, pero no crearlas.
  • Un repositorio en el que trabajará el candidato, en cualquier servicio de Git. ¿Todavía no tienes repositorio? Empieza con un proyecto en blanco (paso 2).

Crea una prueba

Abre Pruebas en la barra lateral y elige Nueva prueba. Ponle el nombre que verán los candidatos, como Rate limiter, en el campo Nombra esta prueba.

En los ajustes de la derecha, elige un Límite de tiempo. 90 minutos es el valor por defecto y encaja con la mayoría de las tareas de backend; también puedes elegir de 30 minutos a 4 horas, o una duración personalizada. Una vez que existe el borrador, los cambios se guardan sobre la marcha.

Añade un reto desde tu repositorio

Pega la URL del repositorio en URL del repositorio y elige Comprobar. Kendor muestra una vista previa de la importación: el número de archivos, su tamaño y si el repositorio ya tiene un kendor.yaml.

  • Servicios: github.com, gitlab.com y bitbucket.org, además de tu propio GitHub Enterprise Server, GitLab, Gitea o Forgejo.
  • Repositorios privados: un propietario de la organización añade primero un token de solo lectura en Integraciones → Servicios de código. Los tokens se guardan cifrados y Kendor solo muestra sus últimos cuatro caracteres.
  • Una carpeta de un monorepo: pega un enlace a una rama o carpeta (por ejemplo github.com/acme/platform/tree/main/services/billing) y solo se importa esa parte.

Define el Título, el Lenguaje y las Bases de datos que necesite el proyecto, y elige Añadir reto. La importación es una copia de ese commit: los pushes posteriores al repositorio no cambian una prueba que ya está en circulación.

¿Sin repositorio? En O añadir:, elige Proyecto en blanco para empezar desde una de las plantillas de Kendor, o Un solo archivo para una pregunta de estilo algorítmico.

Comprueba cómo se ejecuta

Un kendor.yaml en la raíz del proyecto le indica a Kendor cómo instalarlo, iniciarlo y probarlo. Cuando el repositorio no tiene uno, el editor te abre la Configuración de ejecución. Rellena el formulario, o cambia a YAML sin procesar, y guarda: Kendor escribe kendor.yaml y reinicia el sandbox con él.

Un proyecto pequeño con una base de datos PostgreSQL tiene este aspecto:

kendor.yaml
version: 1
runtime:
  type: python
  version: "3.12"
databases:
  - type: postgres
    version: "18"
    init: db/schema.sql
install:
  commands:
    - pip install --user -r requirements.txt
services:
  app:
    dev:
      command: uvicorn main:app --host $HOST --port $PORT --reload
      port: 8000
    test:
      command: pytest --tap-stream
preview:
  service: app

Kendor inicia la base de datos dentro del sandbox y le pasa su cadena de conexión a tu aplicación como DATABASE_URL. Elige Vista previa como candidato para ver la aplicación en ejecución exactamente como la verá un candidato.

Asegúrate de que los tests se ejecutan

Los candidatos ejecutan ellos mismos los tests del proyecto, desde la pestaña Tests del editor o desde la terminal, tantas veces como quieran. Los tests son archivos normales del proyecto, así que los candidatos también pueden leerlos.

La pestaña Tests ejecuta el comando test de kendor.yaml. Para obtener una fila por test en lugar de un único aprobado o suspenso, haz que el comando imprima TAP: lo hacen pytest --tap-stream (el Python de Kendor incluye pytest-tap) y el node --test integrado de Node. Ejecuta la batería una vez en la vista previa para comprobarla.

Lanza la prueba

De vuelta en los ajustes de la prueba, añade Revisores predeterminados y revisa la Caducidad de la invitación (7 días salvo que la cambies). Para que los candidatos puedan usar agentes de programación con IA en la terminal, activa Asistentes de IA en la terminal. Con las claves de API propias de tu organización tienen Claude Code y Codex; con su propia cuenta, también pueden ejecutar Antigravity, GitHub Copilot, Cline, OpenCode o Cursor.

La Lista de lanzamiento muestra lo que falta. Una prueba necesita un título, al menos un reto y una configuración de ejecución válida. Elige Lanzar y la prueba pasa a estar Disponible.

Invita a un candidato

Abre Candidatos y elige Invitar candidato. Introduce uno o más correos, elige la prueba (solo se muestran las pruebas disponibles) y elige Enviar invitación.

Cada candidato recibe su propio enlace por correo. No necesitan cuenta: introducen su nombre y el temporizador empieza cuando eligen Empezar prueba. Si prefieres enviar tú el enlace, usa Copiar enlace de invitación en la fila del candidato.

Consejo. Envía la primera invitación a ti mismo para ver exactamente lo que ven los candidatos.

Revisa la entrega

Cuando el candidato entrega, ábrelo desde Candidatos y elige Abrir revisión. Encontrarás su código y sus diferencias en Solución, además de las pestañas Cronología, Terminal, Agentes de IA y Actividad.

Cada revisor registra una recomendación, de Sí rotundo a No rotundo, con una nota opcional. Después alguien toma la decisión: Promover o Rechazar. Ninguna de las dos envía un correo al candidato, así que tú decides cuándo y cómo recibe la respuesta. Marcar como aprobado y Marcar como no aprobado son distintas: envían al candidato su resultado por correo de inmediato. Consulta Revisar una entrega.

¿Te ha resultado útil este artículo?