Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
141 lines (92 loc) · 6.88 KB

CONTRIBUTING.md

File metadata and controls

141 lines (92 loc) · 6.88 KB

Contribuir a Roo Code

Roo Code es un proyecto impulsado por la comunidad y valoramos profundamente cada contribución. Para agilizar la colaboración, operamos con un enfoque de "primero la incidencia", lo que significa que todas las solicitudes de extracción (PR) deben estar primero vinculadas a una incidencia de GitHub. Por favor, revise esta guía detenidamente.

Tabla de contenidos

Antes de contribuir

1. Código de conducta

Todos los colaboradores deben adherirse a nuestro Código de conducta.

2. Hoja de ruta del proyecto

Nuestra hoja de ruta guía la dirección del proyecto. Alinee sus contribuciones con estos objetivos clave:

La fiabilidad es lo primero

  • Asegúrese de que la edición de diferencias y la ejecución de comandos sean consistentemente fiables.
  • Reduzca los puntos de fricción que desalientan el uso regular.
  • Garantice un funcionamiento fluido en todas las localidades y plataformas.
  • Amplíe el soporte robusto para una amplia variedad de proveedores y modelos de IA.

Experiencia de usuario mejorada

  • Agilice la interfaz de usuario/experiencia de usuario para mayor claridad e intuición.
  • Mejore continuamente el flujo de trabajo para cumplir con las altas expectativas que los desarrolladores tienen de las herramientas de uso diario.

Liderando el rendimiento de los agentes

  • Establezca puntos de referencia de evaluación (evals) exhaustivos para medir la productividad en el mundo real.
  • Facilite que todos puedan ejecutar e interpretar fácilmente estas evaluaciones.
  • Envíe mejoras que demuestren un claro aumento en las puntuaciones de las evaluaciones.

Mencione la alineación con estas áreas en sus solicitudes de extracción.

3. Únase a la comunidad de Roo Code

  • Principal: Únase a nuestro Discord y envíe un mensaje directo a Hannes Rudolph (hrudolph).
  • Alternativa: Los colaboradores experimentados pueden participar directamente a través de Proyectos de GitHub.

Encontrar y planificar su contribución

Tipos de contribuciones

  • Correcciones de errores: abordar problemas de código.
  • Nuevas características: agregar funcionalidad.
  • Documentación: mejorar las guías y la claridad.

Enfoque de primero la incidencia

Todas las contribuciones comienzan con una incidencia de GitHub utilizando nuestras plantillas simplificadas.

  • Compruebe las incidencias existentes: busque en Incidencias de GitHub.
  • Cree una incidencia utilizando:
    • Mejoras: plantilla "Solicitud de mejora" (lenguaje sencillo centrado en el beneficio del usuario).
    • Errores: plantilla "Informe de error" (reproducción mínima + esperado vs. real + versión).
  • ¿Quiere trabajar en ello? Comente "Reclamando" en la incidencia y envíe un mensaje directo a Hannes Rudolph (hrudolph) en Discord para que se le asigne. La asignación se confirmará en el hilo.
  • Las solicitudes de extracción deben enlazar a la incidencia. Las solicitudes de extracción no enlazadas pueden cerrarse.

Decidir en qué trabajar

Informar de errores

  • Compruebe primero si existen informes.
  • Cree un nuevo error utilizando la plantilla "Informe de error" con:
    • Pasos de reproducción claros y numerados
    • Resultado esperado vs. real
    • Versión de Roo Code (obligatorio); proveedor/modelo de API si es relevante
  • Problemas de seguridad: informe de forma privada a través de avisos de seguridad.

Proceso de desarrollo y envío

Configuración de desarrollo

  1. Bifurcar y clonar:
git clone https://github.com/SU_NOMBRE_DE_USUARIO/Roo-Code.git
  1. Instalar dependencias:
pnpm install
  1. Depuración: Abra con VS Code (F5).

Directrices para escribir código

  • Una solicitud de extracción centrada por característica o corrección.
  • Siga las mejores prácticas de ESLint y TypeScript.
  • Escriba confirmaciones claras y descriptivas que hagan referencia a las incidencias (p. ej., Corrige #123).
  • Proporcione pruebas exhaustivas (npm test).
  • Rebase a la rama main más reciente antes del envío.

Envío de una solicitud de extracción

  • Comience como una PR en borrador si busca comentarios tempranos.
  • Describa claramente sus cambios siguiendo la plantilla de solicitud de extracción.
  • Enlace la incidencia en la descripción/título de la PR (p. ej., "Corrige #123").
  • Proporcione capturas de pantalla/vídeos para los cambios en la interfaz de usuario.
  • Indique si es necesario actualizar la documentación.

Política de solicitud de extracción

  • Debe hacer referencia a una incidencia de GitHub asignada. Para que se le asigne: comente "Reclamando" en la incidencia y envíe un mensaje directo a Hannes Rudolph (hrudolph) en Discord. La asignación se confirmará en el hilo.
  • Las solicitudes de extracción no enlazadas pueden cerrarse.
  • Las solicitudes de extracción deben pasar las pruebas de CI, estar alineadas con la hoja de ruta y tener una documentación clara.

Proceso de revisión

  • Clasificación diaria: comprobaciones rápidas por parte de los mantenedores.
  • Revisión semanal en profundidad: evaluación exhaustiva.
  • Itere rápidamente en función de los comentarios.

Legal

Al contribuir, acepta que sus contribuciones se licenciarán bajo la Licencia Apache 2.0, de acuerdo con la licencia de Roo Code.