Discusiones

Código Abierto — GitScrum MCP Server es código abierto bajo la licencia MIT. Disponible en npm y en GitHub. Servidor Model Context Protocol para GitScrum — Claude, GitHub Copilot, Cursor y cualquier cliente compatible con MCP tienen acceso operacional completo a tu stack de gestión de proyectos.

La herramienta discussion proporciona 6 acciones para crear y gestionar canales de discusión con hilos dentro de tus proyectos. Las discusiones son la alternativa estructurada a los mensajes de chat dispersos — mantienen las decisiones de arquitectura, revisiones de diseño, propuestas de funcionalidades y conversaciones del equipo organizadas y buscables dentro del contexto del proyecto.

Cada discusión vive dentro de un proyecto, soporta comentarios con hilos y puede abrirse o cerrarse a medida que se resuelven los temas. Tu asistente de IA puede crear discusiones, publicar comentarios, dar seguimiento a hilos abiertos y cerrar temas resueltos — todo a través de lenguaje natural en tu IDE o cliente de IA.

Resumen de acciones

Listar discusiones

La acción list devuelve todas las discusiones dentro de un proyecto. Opcionalmente puedes filtrar por estado para ver solo los hilos abiertos o cerrados. Cada discusión en la respuesta incluye su uuid, título, estado, fecha de creación y autor — proporcionando el contexto necesario para operaciones posteriores.

Parámetros requeridos

Parámetros opcionales

You:  "Lista todas las discusiones en el proyecto Backend"
AI:   Llama a discussion action=list → devuelve todos los hilos de discusión

You:  "Muéstrame las discusiones abiertas en el proyecto Mobile App"
AI:   Llama a discussion action=list con status="open" → devuelve hilos activos

You:  "¿Hay discusiones cerradas sobre el rediseño de la API?"
AI:   Llama a discussion action=list con status="closed" → la IA filtra por tema

Obtener detalles de una discusión

La acción get devuelve el objeto completo de la discusión — título, descripción, estado, autor, fecha de creación y metadatos. Este es el punto de partida cuando necesitas contexto completo sobre un hilo específico.

Parámetros requeridos

You:  "Muéstrame los detalles de la discusión sobre diseño de API"
AI:   Encuentra la discusión por título → llama a discussion action=get → devuelve datos completos del hilo

You:  "¿Qué se decidió en la discusión de revisión de arquitectura?"
AI:   Llama a discussion action=get → devuelve la descripción y el contexto

Crear discusiones

La acción create inicia un nuevo hilo de discusión dentro de un proyecto. Cada discusión necesita un título; la descripción es opcional pero recomendada para proporcionar contexto a los participantes.

Parámetros requeridos

Parámetros opcionales

Ejemplos de prompts

You:  "Inicia una discusión sobre la estrategia de autenticación de API en el proyecto Backend"
AI:   Llama a discussion action=create con title="API Authentication Strategy",
      description con contexto sobre el tema

You:  "Crea una discusión 'Plan de Migración de Base de Datos' con detalles sobre
       el cronograma de migración de PostgreSQL a CockroachDB"
AI:   Llama a discussion action=create con título y descripción en Markdown

You:  "Abre un hilo sobre el checklist de lanzamiento de la app móvil"
AI:   Llama a discussion action=create con title="Mobile App Launch Checklist"

Actualizar discusiones

La acción update modifica el título, la descripción o el estado de una discusión existente. Solo los campos que especifiques se modifican — todo lo demás permanece intacto. Cerrar una discusión indica que el tema está resuelto.

Parámetros requeridos

Parámetros opcionales

You:  "Cierra la discusión de autenticación de API — decidimos usar OAuth2"
AI:   Encuentra la discusión → llama a discussion action=update con status="closed"

You:  "Actualiza el título de la discusión de migración a 'Plan de Migración de Base de Datos v2'"
AI:   Llama a discussion action=update con title="Database Migration Plan v2"

You:  "Reabre la discusión sobre estrategia de despliegue"
AI:   Llama a discussion action=update con status="open"

Comentarios en discusiones

Los comentarios forman la conversación con hilos dentro de una discusión. Cada comentario soporta formato Markdown, permitiendo contenido enriquecido incluyendo bloques de código, enlaces y texto formateado.

Listar comentarios

La acción comment_list devuelve todos los comentarios de una discusión en orden cronológico.

You:  "Muestra todos los comentarios de la discusión de arquitectura"
AI:   Llama a discussion action=comment_list → devuelve comentarios con hilos

You:  "¿Qué ha dicho el equipo sobre el rediseño de la API?"
AI:   Encuentra la discusión → llama a comment_list → resume la conversación

Crear comentarios

La acción comment_create agrega un nuevo comentario a una discusión existente. Los comentarios soportan Markdown completo — bloques de código, listas con viñetas, enlaces y texto formateado.

You:  "Agrega un comentario a la discusión de API: 'Después de revisar los benchmarks,
       recomiendo que usemos GraphQL para la API pública'"
AI:   Llama a discussion action=comment_create con comentario en Markdown

You:  "Publica los pros y contras de cada opción de base de datos en el hilo de migración"
AI:   Llama a discussion action=comment_create con lista formateada en Markdown

You:  "Comenta en la discusión de arquitectura con notas de la reunión de hoy"
AI:   Llama a discussion action=comment_create con notas de la reunión en Markdown

Flujo de comunicación con hilos

Las discusiones funcionan mejor cuando se combinan con otras herramientas de MCP para crear un proceso estructurado de toma de decisiones:

1. Iniciar la conversación

Crea una discusión con un marco claro y contexto de fondo.

You:  "Crea una discusión 'Estrategia de Auth para API v3' en el proyecto Backend.
       Incluye contexto sobre nuestra configuración actual de JWT y la necesidad de soportar OAuth2."
AI:   Crea la discusión con título y descripción detallada en Markdown

2. Recopilar opiniones

Los miembros del equipo agregan comentarios con su análisis y recomendaciones.

You:  "Agrega un comentario con mi análisis: OAuth2 + PKCE para móvil, API keys
       para servidor a servidor, cookies de sesión para el dashboard web"
AI:   Publica un comentario formateado con la recomendación técnica

3. Revisar el hilo

Resume los comentarios para sintetizar las opiniones del equipo.

You:  "Resume los comentarios de la discusión sobre estrategia de autenticación"
AI:   Llama a comment_list → genera un resumen conciso de todas las posiciones

4. Resolver y actuar

Cierra la discusión y crea tareas basadas en la decisión.

You:  "Cierra la discusión de estrategia de autenticación y crea tareas para implementar
       el enfoque de OAuth2 que acordamos"
AI:   Actualiza el estado de la discusión a cerrado → crea tareas a partir de la decisión

Resolución automática de contexto

La herramienta de discusiones soporta resolución automática de contexto. Si tu asistente de IA ya conoce el workspace y proyecto de una llamada anterior en la conversación, mantiene ese contexto. Puedes decir "lista las discusiones" sin especificar el proyecto cada vez, siempre que el contexto se haya establecido previamente.

Próximos pasos

• Comentarios: Gestiona comentarios en tareas para colaboración operativa.
• Wiki: Construye bases de conocimiento del proyecto para documentación a largo plazo.
• Tareas: Crea tareas a partir de los resultados de las discusiones.
• Inicio Rápido: Configura el servidor MCP si aún no lo has hecho.