agent-project-board-sync

nombre: project-board-sync descripción: Sincroniza enjambres de IA con proyectos de GitHub para la gestión visual de tareas, el seguimiento del progreso y la coordinación del equipo tipo: coordinación color: "#A8E6CF" herramientas:

• Bash
• Leer
• Escribir
• Editar
• Glob
• Grep
• LS
• Tareas por hacer: Escribir
• mcp__claude-flow__swarm_init
• mcp__claude-flow__agent_spawn
• mcp__claude-flow__task_orchestrate
• mcp__claude-flow__swarm_status
• mcp__claude-flow__memory_usage
• mcp__claude-flow__github_repo_analyze
• mcp__claude-flow__gestión_de_pull_requests_en_GitHub
• mcp__claude-flow__seguimiento_de_temas_en_GitHub
• mcp__claude-flow__métricas_de_GitHub
• mcp__claude-flow__crear_flujo_de_trabajo
• mcp__claude-flow__workflow_execute hooks: pre:
  • "gh auth status || (echo 'GitHub CLI no autenticado' && exit 1)"
  • "gh project list --owner @me --limit 1 >$dev$null || echo 'No hay proyectos accesibles'"
  • "git status --porcelain || echo 'No está en el repositorio de Git'"
  • "gh api user | jq -r '.login' || echo 'Comprobación de acceso a la API'" post:
  • "gh project list --owner @me --limit 3 | head -5"
  • "gh issue list --limit 3 --json number,title,state"
  • "git branch --show-current || echo 'No estoy en ninguna rama'"
  • "gh repo view --json nombre,descripción"

Sincronización del tablero de proyectos: integración con GitHub Projects

Descripción general

Sincroniza los enjambres de IA con GitHub Projects para la gestión visual de tareas, el seguimiento del progreso y la coordinación del equipo.

Características principales

1. Inicialización del tablero

# Conecta el enjambre a un proyecto de GitHub mediante la CLI de gh
# Obtén los detalles del proyecto
PROJECT_ID=$(gh project list --owner @me --format json | \
  jq -r '.projects[] | select(.title == "Development Board") | .id')# Inicializa el enjambre con el proyecto
npx ruv-swarm github board-init \
  --project-id "$PROJECT_ID" \
  --sync-mode "bidirectional" \
  --create-views "swarm-status,agent-workload,priority"# Crear campos del proyecto para el seguimiento de Swarm
gh project field-create $PROJECT_ID --owner @me \
  --name "Estado de Swarm" \
  --data-type "SINGLE_SELECT" \
  --single-select-options "pendiente,en_curso,completado"

2. Sincronización de tareas

# Sincronizar las tareas de Swarm con las tarjetas del proyecto
npx ruv-swarm github board-sync \
  --map-status '{
    "todo": "Por hacer",
    "in_progress": "En curso",
    "review": "Revisar",
    "done": "Hecho"
  }' \
  --auto-move-cards \
  --update-metadata

3. Actualizaciones en tiempo real

# Habilitar actualizaciones del tablero en tiempo real
npx ruv-swarm github board-realtime \
  --webhook-endpoint "https:/$api.example.com$github-sync" \
  --update-frequency "immediate" \
  --batch-updates false

Configuración

Configuración de la asignación del tablero

# .github$board-sync.yml
versión: 1
proyecto:
  nombre:  «Tablero de desarrollo de IA»
  número: 1
  
asignación:
  # Asignar el estado de las tareas de Swarm a las columnas del tablero
  estado:
    pendiente:  «Backlog»
   assigned: "Ready"
    in_progress: "In Progress"
    review: "Review"
    completed: "Done"
    blocked: "Blocked"
    
  # Asignar los tipos de agente a las etiquetas
  agents:
    coder: "🔧 Desarrollo"
    tester: "🧪 Pruebas"
    analyst: "📊 Análisis"
    designer: "🎨 Diseño"
    architect: "🏗️ Arquitectura"
    
 # Asignar prioridades a los campos del proyecto
  prioridad:
    crítica: "🔴 Crítica"
    alta: "🟡 Alta"
    media: "🟢 Media"
    baja: "⚪ Baja"
    
  # Campos personalizados
  campos:
   - nombre:  «Número de agentes»
      tipo: número
      fuente: task.agents.length
    - nombre:  «Complejidad»
      tipo: selección
      fuente: task.complexity
   - nombre:  «Hora estimada de finalización»
      tipo: fecha
      fuente: task.estimatedCompletion

Ver configuración

// Vistas personalizadas del tablero
{
  "views": [
    {
      "name": "Resumen de Swarm",
      "type": "board",
      "groupBy": "status",
     "filters": ["is:open"],
      "sort": "priority:desc"
    },
    {
      "name": "Carga de trabajo de los agentes",
      "type": "table",
     "groupBy": "agente asignado",
      "columnas": ["título", "estado", "prioridad", "fecha prevista"],
      "orden": "fecha prevista:asc"
    },
    {
     "name": "Progreso del sprint",
      "type": "roadmap",
      "dateField": "eta",
      "groupBy": "milestone"
    }
  ]
}

Funciones de automatización

1. Asignación automática

# Asignar automáticamente tarjetas a los agentes
npx ruv-swarm github board-auto-assign \
  --strategy "load-balanced" \
  --consider "expertise,workload,availability" \
  --update-cards

2. Seguimiento del progreso

# Realizar un seguimiento y visualizar el progreso
npx ruv-swarm github board-progress \
  --show "burndown,velocity,cycle-time" \
  --time-period "sprint" \
  --export-metrics

3. Movimiento inteligente de tarjetas

# Transiciones inteligentes del estado de las tarjetas
npx ruv-swarm github board-smart-move \
  --rules '{
    "auto-progress": "when:all-subtasks-done",
    "auto-review": "when:tests-pass",
    "auto-done": "when:pr-merged"
  }'

Comandos del tablero

Crear tarjetas a partir de incidencias

# Convertir incidencias en tarjetas de proyecto utilizando la CLI de gh
# Listar incidencias con una etiqueta
ISSUES=$(gh issue list --label "enhancement" --json number,title,body)# Añadir incidencias al proyecto
echo "$ISSUES" | jq -r '.[].number' | while read -r issue; do
  gh project item-add $PROJECT_ID --owner @me --url "https:/$github.com/$GITHUB_REPOSITORY$issues/$issue"
done# Procesar con Swarm
npx ruv-swarm github board-import-issues \
  --issues "$ISSUES" \
  --add-to-column "Backlog" \
  --parse-checklist \
  --assign-agents

Operaciones masivas

# Operaciones masivas con tarjetas
npx ruv-swarm github board-bulk \
  --filter "status:blocked" \
  --action "add-label:needs-attention" \
  --notify-assignees

Plantillas de tarjetas

# Crear tarjetas a partir de plantillas
npx ruv-swarm github board-template \
  --template "feature-development" \
  --variables '{
    "feature": "Autenticación de usuario",
    "priority": "alta",
    "agents": ["arquitecto", "programador", "testador"]
  }' \
  --create-subtasks

Sincronización avanzada

1. Sincronización entre varios tableros

# Sincronización entre varios tableros
npx ruv-swarm github multi-board-sync \
  --boards "Development,QA,Release" \
  --sync-rules '{
    "Desarrollo->Control de calidad": "cuando:listo-para-prueba",
    "Control de calidad->Lanzamiento": "cuando:pruebas-superadas"
  }'

2. Sincronización entre organizaciones

# Sincronización de tableros entre organizaciones
npx ruv-swarm github cross-org-sync \
  --source "org1/Project-A" \
  --target "org2/Project-B" \
  --field-mapping "custom" \
  --conflict-resolution "source-wins"

3. Integración con herramientas externas

# Sincronización con herramientas externas
npx ruv-swarm github board-integrate \
  --tool "jira" \
  --mapping "bidirectional" \
  --sync-frequency "5m" \
  --reglas-de-transformación "personalizadas"

Visualización y generación de informes

Análisis del tablero

# Generar análisis del tablero utilizando datos de la CLI de GitHub
# Obtener datos del proyecto
PROJECT_DATA=$(gh project item-list $PROJECT_ID --owner @me --format json)# Obtener métricas de incidencias
ISSUE_METRICS=$(echo "$PROJECT_DATA" | jq -r '.items[] | select(.content.type == "Issue")' | \
 while read -r item; do
    ISSUE_NUM=$(echo "$item" | jq -r '.content.number')
    gh issue view $ISSUE_NUM --json createdAt,closedAt,labels,assignees
 done)# Generar análisis con Swarm
npx ruv-swarm github board-analytics \
  --project-data "$PROJECT_DATA" \
  --issue-metrics "$ISSUE_METRICS" \
  --metrics "throughput,cycle-time,wip" \
  --group-by "agent,priority,type" \
  --time-range "30d" \
  --export "dashboard"

Paneles personalizados

// Configuración del panel de control
{
  "dashboard": {
    "widgets": [
      {
       "type": "chart",
        "title": "Tasa de finalización de tareas",
        "data": "completed-per-day",
        "visualization": "line"
      },
      {
        "type": "gauge",
        "title": "Progreso del sprint",
        "data": "sprint-completion",
        "target": 100
      },
      {
        "type": "heatmap",
        "title": "Actividad de los agentes",
        "data": "agent-tasks-per-day"
      }
    ]
  }
}

Informes

# Generar informes
npx ruv-swarm github board-report \
  --type "sprint-summary" \
  --format "markdown" \
  --include "velocity,burndown,blockers" \
  --distribute "slack,email"

Integración con flujos de trabajo

Gestión de sprints

# Gestionar sprints con swarms
npx ruv-swarm github sprint-manage \
  --sprint "Sprint 23" \
  --auto-populate \
  --capacity-planning \
  --track-velocity

Seguimiento de hitos

# Realizar un seguimiento del progreso de los hitos
npx ruv-swarm github milestone-track \
  --milestone "Lanzamiento de la v2.0" \
  --update-board \
  --show-dependencies \
  --predict-completion

Planificación de lanzamientos

# Planificar lanzamientos utilizando los datos del tablero
npx ruv-swarm github release-plan-board \
  --analyze-velocity \
  --estimate-completion \
  --identify-risks \
  --optimize-scope

Colaboración en equipo

Distribución del trabajo

# Distribuir el trabajo entre el equipo
npx ruv-swarm github board-distribute \
  --strategy "skills-based" \
  --balance-workload \
  --respect-preferences \
  --notify-assignments

Automatización de las reuniones diarias

# Generar informes de reuniones diarias
npx ruv-swarm github standup-report \
  --team "frontend" \
  --include "yesterday,today,blockers" \
  --format "slack" \
  --schedule "daily-9am"

Coordinación de revisiones

# Coordinar revisiones a través del tablero
npx ruv-swarm github review-coordinate \
  --board "Revisión de código" \
  --assign-reviewers \
  --track-feedback \
  --ensure-coverage

Buenas prácticas

1. Organización del tablero

• Definiciones claras de las columnas
• Sistema de etiquetado coherente
• Mantenimiento periódico del tablero
• Reglas de automatización

2. Integridad de los datos

• Validación de la sincronización bidireccional
• Estrategias de resolución de conflictos
• Registros de auditoría
• Copias de seguridad periódicas

3. Adopción por parte del equipo

• Materiales de formación
• Flujos de trabajo claros
• Revisiones periódicas
• Ciclos de retroalimentación

Resolución de problemas

Problemas de sincronización

# Diagnosticar problemas de sincronización
npx ruv-swarm github board-diagnose \
  --check "permissions,webhooks,rate-limits" \
  --test-sync \
  --show-conflicts

Rendimiento

# Optimizar el rendimiento del tablero
npx ruv-swarm github board-optimize \
  --analyze-size \
  --archive-completed \
  --index-fields \
  --cache-views

Recuperación de datos

# Recuperar datos del tablero
npx ruv-swarm github board-recover \
  --backup-id "2024-01-15" \
  --restore-cards \
  --preserve-current \
  --merge-conflicts

Ejemplos

Tablero de desarrollo ágil

# Configurar un tablero ágil
npx ruv-swarm github agile-board \
  --methodology "scrum" \
  --sprint-length "2w" \
  --ceremonies "planning,review,retro" \
  --metrics "velocity,burndown"

Tablero de flujo Kanban

# Configurar el tablero Kanban
npx ruv-swarm github kanban-board \
  --wip-limits '{
    "En curso": 5,
    "Revisión": 3
  }' \
  --seguimiento-del-tiempo-de-ciclo \
  --flujo-continuo

Tablero de proyectos de investigación

# Configurar el tablero de investigación
npx ruv-swarm github research-board \
  --phases "ideación, investigación, experimento, análisis, publicación" \
  --track-citations \
  --collaborate-external

Métricas e indicadores clave de rendimiento

Métricas de rendimiento

# Seguimiento del rendimiento del tablero
npx ruv-swarm github board-kpis \
  --metrics '[
    "tiempo-medio-por-ciclo",
    "rendimiento-por-sprint",
    "porcentaje-de-tiempo-bloqueado",
    "índice-de-aprobación-a-la-primera"
  ]' \
  --dashboard-url

Métricas del equipo

# Realizar un seguimiento del rendimiento del equipo
npx ruv-swarm github team-metrics \
  --board "Development" \
  --per-member \
  --include "velocity,quality,collaboration" \
  --anonymous-option

Véase también: swarm-issue.md, multi-repo-swarm.md