← Volver a la documentación

Integración con GitHub

Vincula un repositorio de GitHub a un proyecto de Willet para que las pull requests actualicen el estado de las tareas automáticamente.

Cómo funciona

Cuando se abre una pull request en un repositorio vinculado y hace referencia a una tarea de Willet con una palabra clave de cierre, la tarea pasa a in_progress. Cuando se fusiona la pull request, la tarea pasa a done. La integración solo avanza el estado de una tarea: las tareas ya completadas o canceladas no se modifican nunca, y una PR reabierta o revertida no hace retroceder el estado de una tarea. Los cambios de estado se atribuyen a "Willet (GitHub)" y la URL de la PR queda registrada en el historial de la tarea.

Configuración

La vinculación se gestiona a través de las herramientas MCP de Willet, no desde el panel. Pide a cualquier agente de IA conectado a Willet que lo configure por ti, o ejecuta las herramientas directamente. Necesitarás el rol de administrador o propietario en la organización de Willet, y acceso de administrador en el repositorio de GitHub.

  1. Inicia sesión en Willet con GitHub. Solicitaremos los permisos necesarios para registrar webhooks en tus repositorios.
  2. Pide a tu agente que llame a la herramienta link_github_repo con el slug de tu organización, el slug del proyecto y el repositorio en formato propietario/repositorio.
  3. Si a tu autorización de GitHub almacenada le faltan permisos, la herramienta te devolverá una URL — ábrela, vuelve a autorizar y ejecuta link_github_repo de nuevo.
link_github_repo org_slug=<org> project_slug=<project> repo=<owner>/<repo>

Referenciar tareas en PRs

Referencia una tarea por su clave legible (el prefijo del proyecto más el número de tarea, como WD-42) o por su ULID de 26 caracteres. Incluye la referencia en cualquier parte del título, la descripción o el nombre de la rama del PR, y combínala con una palabra clave de cierre. Puedes añadir tantas tareas como quieras después de una palabra clave.

Fixes WD-12, WD-13 and WD-14

Palabras clave de cierre

La coincidencia no distingue entre mayúsculas y minúsculas ni entre tildes, y funciona en todos los idiomas que admite Willet. Las palabras clave estándar en inglés (close/closes/closed, fix/fixes/fixed, resolve/resolves/resolved, complete/completes/completed) funcionan, junto con sus equivalentes naturales en alemán, español, francés, italiano, japonés, coreano y turco. Cualquiera de los dos órdenes es válido — "fix <tarea>" o "<tarea> fixed" — para adaptarse a los idiomas en los que el verbo va naturalmente al final.

Seguridad

Cada repositorio vinculado tiene su propio secreto HMAC de webhook por mapeo, de modo que un webhook sin firmar o reproducido no puede mover tareas. Los eventos de webhook de un repositorio sin mapeo en Willet se descartan. La integración confía en el mapeo repositorio↔proyecto en sí: cualquier persona que pueda fusionar una PR en el repositorio vinculado puede avanzar el estado de las tareas, así que no vincules repositorios cuyos colaboradores no deberían poder actualizar tus tareas.