Projects
Projects trabaja con los tableros de tareas de GitHub Projects. Lee los tableros de una organización o de un usuario y sus tareas, crea tareas nuevas, les cambia el estado (por ejemplo de Todo a In progress) o cualquier otro campo del tablero, y las archiva. Una tarea puede ser un borrador, con título y notas, o un issue o pull request que ya existe.
Cuándo usarlo
- Un agente que, en una reunión o un chat, apunta las tareas acordadas en el tablero del proyecto.
- Mover una tarea a
Donecuando se despliega o cuando alguien lo pide. - Un informe de las tareas en curso, pendientes o de una persona.
- Crear un tablero nuevo para un proyecto.
Configuración
Necesitas una credencial GitHub API. Los tableros de una organización necesitan un token con el permiso Projects de esa organización (lectura, o lectura y escritura para crear y modificar). Los tableros personales necesitan un token clásico con el permiso project, porque los tokens fine-grained no llegan a ellos. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial GitHub API. |
| Operation (obligatorio) | List Projects, List Fields, List Items, Create Item, Update Item, Archive Item o Create Project. |
| Owner (obligatorio) | La organización o el usuario dueño de los tableros, como en github.com/<owner>. |
| Project | El número del tablero (github.com/orgs/<owner>/projects/<número>) o su título exacto. |
| New project title | Create Project: el título del tablero nuevo. |
| Task | Update Item y Archive Item: la tarea, por su ID (PVTI_…, de List Items) o por su título. |
| Title / Notes | Create Item: el título y la descripción de la tarea nueva. En Update Item, el nuevo título o las notas de un borrador. |
| Issue or pull request | Create Item: el enlace de un issue o pull request que ya existe, para añadirlo al tablero en vez de crear un borrador. |
| Field values | Los campos que se fijan, por nombre: Status=In progress; Priority=High; Due=2026-11-10. Las opciones tienen que existir en el tablero (las da List Fields). |
| Filter | List Items: solo las tareas cuyo título o algún campo contiene este texto (un estado, una persona, una palabra). |
| Limit | Cuántos tableros o tareas devolver como máximo (por defecto, 100). |
Resultado
List Projects: el número, el título, el enlace, si está cerrado y cuántas tareas tiene cada tablero.List Fields: cada campo del tablero con su tipo y sus opciones (por ejemplo, las columnas deStatus).List Items: por tarea, su ID, si es borrador, issue o pull request, el título, el estado y el resto de campos, las personas asignadas, el enlace, el repositorio y las notas.Create Item,Update Item,Archive ItemyCreate Project: la confirmación, con el ID de la tarea o el número del tablero y lo que se ha cambiado.
Si una opción no existe en el tablero, el error dice cuáles son las válidas. Una tarea archivada se puede recuperar desde el archivo del tablero en GitHub.
Como herramienta de un agente
Conéctalo al puerto de herramientas de un Agente o un Voice Agent con Owner y Project fijos. La IA rellena el título, las notas, la tarea y los campos. Conviene darle también List Fields para que sepa qué estados tiene el tablero. Ver Tool Mode.
Ejemplo
Un agente de voz que, en la reunión del proyecto, apunta las tareas:
- Añade Projects con
Create Item, Ownermi-orgy Project3, conectado como herramienta del Voice Agent. - Añade otro Projects con
Update Itempara que pueda moverlas de estado. - En la reunión: «apunta que Pedro revise la PR 412, en curso»; el agente crea la tarea con
Status=In progress.
Componentes relacionados
- Issue: los issues de un repositorio.
- Commits: qué se ha cambiado.
- Actions & Deployments: qué se ha desplegado.