agent-project-board-sync

nom : project-board-sync description : Synchronisation des essaims d'IA avec les projets GitHub pour la gestion visuelle des tâches, le suivi de l'avancement et la coordination d'équipe type : coordination couleur : "#A8E6CF" outils :

• Bash
• Lire
• Écriture
• Modifier
• Glob
• Grep
• LS
• À faireÉcrire
• 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__gestion_des_pull_requests_github
• mcp__claude-flow__suivi_des_tickets_GitHub
• mcp__claude-flow__statistiques_github
• mcp__claude-flow__workflow_create
• mcp__claude-flow__workflow_execute hooks : pre :
  • "gh auth status || (echo 'GitHub CLI non authentifié' && exit 1)"
  • "gh project list --owner @me --limit 1 >$dev$null || echo 'Aucun projet accessible'"
  • "git status --porcelain || echo 'Pas dans le dépôt Git'"
  • "gh api user | jq -r '.login' || echo 'Vérification de l'accès à l'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 'Pas sur une branche'"
  • "gh repo view --json nom,description"

Synchronisation du tableau de projet - Intégration des projets GitHub

Présentation

Synchronisez les essaims d’IA avec les projets GitHub pour une gestion visuelle des tâches, un suivi de l’avancement et une coordination d’équipe.

Fonctionnalités principales

1. Initialisation du tableau

# Connecter l'essaim à un projet GitHub à l'aide de la CLI gh
# Récupérer les détails du projet
PROJECT_ID=$(gh project list --owner @me --format json | \
  jq -r '.projects[] | select(.title == "Development Board") | .id')# Initialiser l'essaim avec le projet
npx ruv-swarm github board-init \
  --project-id "$PROJECT_ID" \
  --sync-mode "bidirectional" \
  --create-views "swarm-status,agent-workload,priority"# Créer des champs de projet pour le suivi de Swarm
gh project field-create $PROJECT_ID --owner @me \
  --name "État du Swarm" \
  --data-type "SINGLE_SELECT" \
  --single-select-options "en attente,en cours,terminé"

2. Synchronisation des tâches

# Synchroniser les tâches du swarm avec les cartes du projet
npx ruv-swarm github board-sync \
  --map-status '{
    "todo": "À faire",
    "in_progress": "En cours",
    "review" : "À réviser",
    "done" : "Terminé"
  }' \
  --auto-move-cards \
  --update-metadata

3. Mises à jour en temps réel

# Activer les mises à jour en temps réel du tableau
npx ruv-swarm github board-realtime \
  --webhook-endpoint "https:/$api.example.com$github-sync" \
  --update-frequency "immediate" \
  --batch-updates false

Configuration

Configuration du mappage du tableau

# .github$board-sync.yml
version: 1
project:
  name: "Tableau de développement IA"
  number: 1
  
mapping:
  # Mappage des statuts des tâches Swarm aux colonnes du tableau
  status:
    pending: "Backlog"
   assigned :  « Ready »
    in_progress :  « En cours »
    review :  « Révision »
    completed :  « Terminé »
    blocked :  « Bloqué »
    
  # Mappage des types d’agents vers les étiquettes
  agents :
    coder :  « 🔧 Développement »
    testeur :  « 🧪 Test »
    analyste :  « 📊 Analyse »
    concepteur :  « 🎨 Conception »
    architecte :  « 🏗️ Architecture »
    
 # Mappage des priorités aux champs du projet
  priorité :
    critique :  « 🔴 Critique »
    élevée :  « 🟡 Élevée »
    moyenne :  « 🟢 Moyenne »
    faible :  « ⚪ Faible »
    
  # Champs personnalisés
  champs :
   - nom :  « Nombre d’agents »
      type : nombre
      source : task.agents.length
    - nom :  « Complexité »
      type : liste déroulante
      source : task.complexity
   - nom :  « Heure d'achèvement estimée »
      type : date
      source : task.estimatedCompletion

Afficher la configuration

// Vues personnalisées du tableau
{
  "views": [
    {
      "name": "Aperçu Swarm",
      "type": "board",
      "groupBy": "status",
     "filters": ["is:open"],
      "sort": "priority:desc"
    },
    {
      "name": "Charge de travail des agents",
      "type": "table",
     "groupBy": "assignedAgent",
      "columns": ["title", "status", "priority", "eta"],
      "sort": "eta:asc"
    },
    {
     "name": "Progression du sprint",
      "type": "roadmap",
      "dateField": "eta",
      "groupBy": "milestone"
    }
  ]
}

Fonctionnalités d’automatisation

1. Attribution automatique

# Attribuer automatiquement des cartes aux agents
npx ruv-swarm github board-auto-assign \
  --strategy "load-balanced" \
  --consider "expertise,workload,availability" \
  --update-cards

2. Suivi de l'avancement

# Suivre et visualiser la progression
npx ruv-swarm github board-progress \
  --show "burndown,velocity,cycle-time" \
  --time-period "sprint" \
  --export-metrics

3. Déplacement intelligent des cartes

# Transitions intelligentes entre les états des cartes
npx ruv-swarm github board-smart-move \
  --rules '{
    "auto-progress": "when:all-subtasks-done",
    "auto-review": "when:tests-pass",
    "auto-done": "when:pr-merged"
  }'

Commandes du tableau

Créer des cartes à partir de tickets

# Convertir des tickets en cartes de projet à l’aide de la CLI gh
# Lister les tickets avec un label
ISSUES=$(gh issue list --label "enhancement" --json number,title,body)# Ajouter des tickets au projet
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# Traitement avec Swarm
npx ruv-swarm github board-import-issues \
  --issues "$ISSUES" \
  --add-to-column "Backlog" \
  --parse-checklist \
  --assign-agents

Opérations groupées

# Opérations groupées sur les cartes
npx ruv-swarm github board-bulk \
  --filter "status:blocked" \
  --action "add-label:needs-attention" \
  --notify-assignees

Modèles de cartes

# Créer des cartes à partir de modèles
npx ruv-swarm github board-template \
  --template "feature-development" \
  --variables '{
    "feature": "Authentification utilisateur",
    "priority": "high",
    "agents": ["architect", "coder", "tester"]
  }' \
  --create-subtasks

Synchronisation avancée

1. Synchronisation multi-tableaux

# Synchronisation entre plusieurs tableaux
npx ruv-swarm github multi-board-sync \
  --boards "Development,QA,Release" \
  --sync-rules '{
    "Development->QA" : "when:ready-for-test",
    "QA->Release" : "when:tests-pass"
  }'

2. Synchronisation inter-organisations

# Synchronisation des tableaux entre organisations
npx ruv-swarm github cross-org-sync \
  --source "org1/Project-A" \
  --target "org2/Project-B" \
  --field-mapping "custom" \
  --conflict-resolution "source-wins"

3. Intégration d’outils externes

# Synchronisation avec des outils externes
npx ruv-swarm github board-integrate \
  --tool "jira" \
  --mapping "bidirectional" \
  --sync-frequency "5m" \
  --règles-de-transformation "personnalisées"

Visualisation et rapports

Analyses du tableau

# Générer des analyses de tableau à partir des données de la CLI GitHub
# Récupérer les données du projet
PROJECT_DATA=$(gh project item-list $PROJECT_ID --owner @me --format json)# Récupérer les métriques des tickets
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)# Générer des analyses avec 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"

Tableaux de bord personnalisés

// Configuration du tableau de bord
{
  "dashboard": {
    "widgets": [
      {
       "type": "chart",
        "title": "Taux d'achèvement des tâches",
        "data": "completed-per-day",
        "visualization": "line"
      },
      {
        "type": "gauge",
        "title": "Progression du sprint",
        "data": "sprint-completion",
        "target": 100
      },
      {
        "type": "heatmap",
        "title": "Activité des agents",
        "data": "tâches-agents-par-jour"
      }
    ]
  }
}

Rapports

# Générer des rapports
npx ruv-swarm github board-report \
  --type "sprint-summary" \
  --format "markdown" \
  --include "velocity,burndown,blockers" \
  --distribute "slack,email"

Intégration au workflow

Gestion des sprints

# Gérer les sprints avec Swarms
npx ruv-swarm github sprint-manage \
  --sprint "Sprint 23" \
  --auto-populate \
  --capacity-planning \
  --track-velocity

Suivi des jalons

# Suivre la progression des jalons
npx ruv-swarm github milestone-track \
  --milestone "v2.0 Release" \
  --update-board \
  --show-dependencies \
  --predict-completion

Planification des versions

# Planifier les versions à l’aide des données du tableau
npx ruv-swarm github release-plan-board \
  --analyze-velocity \
  --estimate-completion \
  --identify-risks \
  --optimize-scope

Collaboration au sein de l'équipe

Répartition du travail

# Répartir le travail au sein de l'équipe
npx ruv-swarm github board-distribute \
  --strategy "skills-based" \
  --balance-workload \
  --respect-preferences \
  --notify-assignments

Automatisation des réunions stand-up

# Générer des rapports de stand-up
npx ruv-swarm github standup-report \
  --team "frontend" \
  --include "hier, aujourd'hui, blocages" \
  --format "slack" \
  --schedule "daily-9am"

Coordination des revues

# Coordonner les revues via un tableau
npx ruv-swarm github review-coordinate \
  --board "Code Review" \
  --assign-reviewers \
  --track-feedback \
  --ensure-coverage

Bonnes pratiques

1. Organisation du tableau

• Définitions claires des colonnes
• Système de libellé cohérent
• Mise à jour régulière du tableau
• Règles d'automatisation

2. Intégrité des données

• Validation de la synchronisation bidirectionnelle
• Stratégies de résolution des conflits
• Pistes d'audit
• Sauvegardes régulières

3. Adoption par l'équipe

• Supports de formation
• Flux de travail clairs
• Révisions régulières
• Boucles de rétroaction

Dépannage

Problèmes de synchronisation

# Diagnostiquer les problèmes de synchronisation
npx ruv-swarm github board-diagnose \
  --check "permissions,webhooks,rate-limits" \
  --test-sync \
  --show-conflicts

Performances

# Optimiser les performances du tableau
npx ruv-swarm github board-optimize \
  --analyze-size \
  --archive-completed \
  --index-fields \
  --cache-views

Récupération des données

# Récupérer les données du tableau
npx ruv-swarm github board-recover \
  --backup-id "2024-01-15" \
  --restore-cards \
  --preserve-current \
  --merge-conflicts

Exemples

Tableau de développement agile

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

Tableau Kanban

# Configurer un tableau Kanban
npx ruv-swarm github kanban-board \
  --wip-limits '{
    "En cours" : 5,
    "Révision" : 3
  }' \
  --cycle-time-tracking \
  --continuous-flow

Tableau de projet de recherche

# Configuration du tableau de recherche
npx ruv-swarm github research-board \
  --phases "idéation, recherche, expérimentation, analyse, publication" \
  --suivi-des-citations \
  --collaboration-externe

Indicateurs et KPI

Indicateurs de performance

# Suivi des performances du tableau
npx ruv-swarm github board-kpis \
  --metrics '[
    "durée moyenne du cycle",
    "débit par sprint",
    "pourcentage de temps bloqué",
    "taux de réussite dès le premier essai"
  ]' \
  --dashboard-url

Indicateurs d'équipe

# Suivre les performances de l'équipe
npx ruv-swarm github team-metrics \
  --board "Development" \
  --per-member \
  --include "velocity,quality,collaboration" \
  --anonymous-option

Voir aussi : swarm-issue.md, multi-repo-swarm.md