G-Bot

G-Bot - Compañero de productividad que automatiza tareas complejas para que vos te enfoqués en crear

G-Bot es una extensión de Visual Studio Code para acelerar los flujos DevOps de equipos de desarrollo: integra Azure DevOps para Work Items y Pull Requests, realiza code review con IA usando GitHub Copilot y genera documentación técnica en Word/PDF.

Capacidades

• Integración con Azure DevOps para Work Items y Pull Requests.
• Revisión de cambios staged/unstaged con IA (Copilot).
• Análisis de riesgo de cambios (LOW, MEDIUM, HIGH, CRITICAL).
• Comparación de branches y estadísticas de cambios.
• Generación de documentos Word con estilos configurables.
• Generación de PDFs desde Work Items con enlaces e imágenes.
• Panel de revisión en Source Control y sidebar operativo.

Instalación

Opción 1: VSIX

1. Descarga el archivo VSIX de la versión deseada.
2. Instala con:

code --install-extension G-Bot-3.0.1.vsix

Opción 2: Marketplace

1. Abre Extensions en VS Code.
2. Busca G-Bot.
3. Selecciona Install.

Configuración Base

Todas las configuraciones usan el namespace gbot.

• gbot.azure.organization
• gbot.azure.pat
• gbot.devops.organization
• gbot.devops.pat
• gbot.sharepoint.localPath
• gbot.sharepoint.baseUrl
• gbot.template.path
• gbot.template.outputDir
• gbot.summary.method
• gbot.prReview.aiModel
• gbot.prReview.ignoredFilePatterns
• gbot.documentation.url
• gbot.debug

Configuración de Tokens (PAT)

G-Bot usa dos credenciales PAT diferentes para separar permisos por tipo de operación.

1) Azure Boards / Work Items

Se usa para consultar WIQL, leer Work Items y generar Word/PDF.

• Settings usados:
  • gbot.azure.organization
  • gbot.azure.pat
• Organización típica:
  • ORG-BOARD (ajustable según tu entorno)
• Permisos requeridos del PAT:
  • Code (Read)
  • Identity (Read)
  • Work Items (Read & Write)

2) Azure DevOps Git / Pull Requests

Se usa para obtener PRs, commits, diffs y publicar comentarios de revisión.

• Settings usados:
  • gbot.devops.organization
  • gbot.devops.pat
• Organización típica:
  • ORG-PR (ajustable según tu entorno)
• Permisos requeridos del PAT:
  • Code (Read)
  • Project and Team (Read)
  • Pull Request Threads (Read & Write)
  • Work Items (Read)

Matriz rápida de permisos por flujo

Comandos Disponibles

• G-Bot: Show Sidebar
• G-Bot: Refrescar Sidebar
• G-Bot: Abrir Log
• G-Bot: Show Output Channel
• G-Bot: Review Unstaged Changes
• G-Bot: Review Staged Changes
• G-Bot: Analyze Risk
• G-Bot: Compare Branches
• G-Bot: Show Change Stats
• G-Bot: Next Comment
• G-Bot: Previous Comment

Guía Rápida

1. Ejecuta G-Bot: Show Sidebar.
2. Configura organizaciones y tokens PAT.
3. Guarda configuración y valida conexión.
4. Ejecuta revisión de cambios desde Code Review.
5. Genera documento Word o PDF según el flujo.

Troubleshooting

El sidebar no aparece automáticamente al iniciar VS Code

Es comportamiento esperado. La extensión se activa, pero la vista no se abre sola. Usa G-Bot: Show Sidebar o el ícono en Activity Bar.

Error 401 en Work Items o PDFs

• Verifica gbot.azure.organization y gbot.azure.pat.
• Confirma scopes: Code (Read), Identity (Read) y Work Items (Read & Write).

Error al publicar comentarios en PR

• Verifica gbot.devops.organization y gbot.devops.pat.
• Confirma scopes: Code (Read), Project and Team (Read), Pull Request Threads (Read & Write) y Work Items (Read).

Identidad

• Nombre del producto: G-Bot
• Namespace interno: gbot
• Chat participant: @gbot
• Slogan oficial: G-Bot - Compañero de productividad que automatiza tareas complejas para que vos te enfoqués en crear

Autoría

Gerald Barquero Valverde

Con colaboración de GitHub Copilot para automatización y productividad del flujo de desarrollo.