agent-project-board-sync

название: project-board-sync описание: Синхронизация роев ИИ с проектами GitHub для визуального управления задачами, отслеживания прогресса и координации работы команды тип: координация цвет: "#A8E6CF" инструменты:

• Bash
• Читать
• Запись
• Редактировать
• Glob
• Grep
• LS
• Список дел Запись
• 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__github_pr_manage
• mcp__claude-flow__отслеживание_задач_на_GitHub
• mcp__claude-flow__показатели_github
• mcp__claude-flow__workflow_create
• mcp__claude-flow__workflow_execute хуки: pre:
  • "gh auth status || (echo 'GitHub CLI не авторизован' && exit 1)"
  • "gh project list --owner @me --limit 1 >$dev$null || echo 'Нет доступных проектов'"
  • "git status --porcelain || echo 'Не находится в репозитории Git'"
  • "gh api user | jq -r '.login' || echo 'Проверка доступа к 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 'Не находится на ветке'"
  • "gh repo view --json name,description"

Синхронизация доски проектов — интеграция с GitHub Projects

Обзор

Синхронизируйте AI swarms с GitHub Projects для визуального управления задачами, отслеживания прогресса и координации работы команды.

Основные функции

1. Инициализация доски

# Подключение роя к проекту GitHub с помощью gh CLI
# Получение сведений о проекте
PROJECT_ID=$(gh project list --owner @me --format json | \
  jq -r '.projects[] | select(.title == "Development Board") | .id')# Инициализируйте рой с проектом
npx ruv-swarm github board-init \
  --project-id "$PROJECT_ID" \
  --sync-mode "bidirectional" \
  --create-views "swarm-status,agent-workload,priority"# Создание полей проекта для отслеживания Swarm
gh project field-create $PROJECT_ID --owner @me \
  --name "Состояние Swarm" \
  --data-type "SINGLE_SELECT" \
  --single-select-options "pending,in_progress,completed"

2. Синхронизация задач

# Синхронизация задач Swarm с карточками проекта
npx ruv-swarm github board-sync \
  --map-status '{
    "todo": "To Do",
    "in_progress": "In Progress",
    "review": "На рассмотрении",
    "done": "Выполнено"
  }' \
  --auto-move-cards \
  --update-metadata

3. Обновления в реальном времени

# Включение обновлений доски в реальном времени
npx ruv-swarm github board-realtime \
  --webhook-endpoint "https:/$api.example.com$github-sync" \
  --update-frequency "immediate" \
  --batch-updates false

Настройка

Настройка сопоставления доски

# .github$board-sync.yml
version: 1
project:
  name: "Доска разработки ИИ"
  number: 1
  
mapping:
  # Сопоставление статусов задач Swarm со столбцами доски
  status:
    pending: "Задачи в очереди"
   assigned: "Ready"
    in_progress: "In Progress"
    review: "Review"
    completed: "Done"
    blocked: "Blocked"
    
  # Сопоставление типов агентов с метками
  agents:
    coder: "🔧 Разработка"
    тестировщик: "🧪 Тестирование"
    аналитик: "📊 Анализ"
    дизайнер: "🎨 Дизайн"
    архитектор: "🏗️ Архитектура"
    
 # Сопоставление приоритетов с полями проекта
  priority:
    critical: "🔴 Критический"
    high: "🟡 Высокий"
    medium: "🟢 Средний"
    low: "⚪ Низкий"
    
  # Пользовательские поля
  fields:
   - name:  «Количество агентов»
      type: number
      source: task.agents.length
    - name:  «Сложность»
      type: select
      source: task.complexity
   - name: "Ожидаемое время завершения"
      type: date
      source: task.estimatedCompletion

Просмотр конфигурации

// Пользовательские представления доски
{
  "views": [
    {
      "name": "Обзор Swarm",
      "type": "board",
      "groupBy": "status",
     "filters": ["is:open"],
      "sort": "priority:desc"
    },
    {
      "name": "Нагрузка агентов",
      "type": "table",
     "groupBy": "assignedAgent",
      "columns": ["title", "status", "priority", "eta"],
      "sort": "eta:asc"
    },
    {
     "name": "Ход спринта",
      "type": "roadmap",
      "dateField": "eta",
      "groupBy": "milestone"
    }
  ]
}

Функции автоматизации

1. Автоматическое назначение

# Автоматическое назначение карточек агентам
npx ruv-swarm github board-auto-assign \
  --strategy "load-balanced" \
  --consider "expertise,workload,availability" \
  --update-cards

2. Отслеживание прогресса

# Отслеживание и визуализация прогресса
npx ruv-swarm github board-progress \
  --show "burndown,velocity,cycle-time" \
  --time-period "sprint" \
  --export-metrics

3. Интеллектуальное перемещение карточек

# Интеллектуальные переходы между состояниями карточек
npx ruv-swarm github board-smart-move \
  --rules '{
    "auto-progress": "when:all-subtasks-done",
    "auto-review": "when:tests-pass",
    "auto-done": "when:pr-merged"
  }'

Команды доски

Создание карточек из задач

# Преобразование задач в карточки проекта с помощью gh CLI
# Список задач с меткой
ISSUES=$(gh issue list --label "enhancement" --json number,title,body)# Добавление задач в проект
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# Обработка с помощью swarm
npx ruv-swarm github board-import-issues \
  --issues "$ISSUES" \
  --add-to-column "Backlog" \
  --parse-checklist \
  --assign-agents

Массовые операции

# Массовые операции с карточками
npx ruv-swarm github board-bulk \
  --filter "status:blocked" \
  --action "add-label:needs-attention" \
  --notify-assignees

Шаблоны карточек

# Создание карточек по шаблонам
npx ruv-swarm github board-template \
  --template "feature-development" \
  --variables '{
    "feature": "Аутентификация пользователя",
    "priority": "high",
    "agents": ["architect", "coder", "tester"]
  }' \
  --create-subtasks

Расширенная синхронизация

1. Синхронизация нескольких досок

# Синхронизация между несколькими досками
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. Синхронизация между организациями

# Синхронизация досок между организациями
npx ruv-swarm github cross-org-sync \
  --source "org1/Project-A" \
  --target "org2/Project-B" \
  --field-mapping "custom" \
  --conflict-resolution "source-wins"

3. Интеграция с внешними инструментами

# Синхронизация с внешними инструментами
npx ruv-swarm github board-integrate \
  --tool "jira" \
  --mapping "bidirectional" \
  --sync-frequency "5m" \
  --transform-rules "custom"

Визуализация и отчётность

Аналитика доски

# Сгенерировать аналитику доски с использованием данных gh CLI
# Получить данные проекта
PROJECT_DATA=$(gh project item-list $PROJECT_ID --owner @me --format json)# Получить метрики задач
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)# Сгенерировать аналитику с помощью 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"

Пользовательские панели инструментов

// Настройка панели инструментов
{
  "dashboard": {
    "widgets": [
      {
       "type": "chart",
        "title": "Доля выполненных задач",
        "data": "completed-per-day",
        "visualization": "line"
      },
      {
        "type": "gauge",
        "title": "Ход спринта",
        "data": "sprint-completion",
        "target": 100
      },
      {
        "type": "heatmap",
        "title": "Активность агентов",
        "data": "agent-tasks-per-day"
      }
    ]
  }
}

Отчёты

# Создание отчетов
npx ruv-swarm github board-report \
  --type "sprint-summary" \
  --format "markdown" \
  --include "velocity,burndown,blockers" \
  --distribute "slack,email"

Интеграция с рабочими процессами

Управление спринтами

# Управление спринтами с помощью swarms
npx ruv-swarm github sprint-manage \
  --sprint "Sprint 23" \
  --auto-populate \
  --capacity-planning \
  --track-velocity

Отслеживание вех

# Отслеживание прогресса по вехам
npx ruv-swarm github milestone-track \
  --milestone "v2.0 Release" \
  --update-board \
  --show-dependencies \
  --predict-completion

Планирование релизов

# Планирование релизов с использованием данных доски
npx ruv-swarm github release-plan-board \
  --analyze-velocity \
  --estimate-completion \
  --identify-risks \
  --optimize-scope

Совместная работа команды

Распределение работы

# Распределение работы между членами команды
npx ruv-swarm github board-distribute \
  --strategy "skills-based" \
  --balance-workload \
  --respect-preferences \
  --notify-assignments

Автоматизация ежедневных собраний

# Создание отчётов о ежедневных собраниях
npx ruv-swarm github standup-report \
  --team "frontend" \
  --include "yesterday,today,blockers" \
  --format "slack" \
  --schedule "daily-9am"

Координация рецензирования

# Координация ревью через доску
npx ruv-swarm github review-coordinate \
  --board "Code Review" \
  --assign-reviewers \
  --track-feedback \
  --ensure-coverage

Рекомендации

1. Организация доски

• Четкие определения столбцов
• Единая система маркировки
• Регулярная очистка доски
• Правила автоматизации

2. Целостность данных

• Проверка двунаправленной синхронизации
• Стратегии разрешения конфликтов
• Журналы аудита
• Регулярное резервное копирование

3. Внедрение в команду

• Учебные материалы
• Четкие рабочие процессы
• Регулярные проверки
• Циклы обратной связи

Устранение неполадок

Проблемы с синхронизацией

# Диагностика проблем с синхронизацией
npx ruv-swarm github board-diagnose \
  --check "permissions,webhooks,rate-limits" \
  --test-sync \
  --show-conflicts

Производительность

# Оптимизация производительности доски
npx ruv-swarm github board-optimize \
  --analyze-size \
  --archive-completed \
  --index-fields \
  --cache-views

Восстановление данных

# Восстановление данных доски
npx ruv-swarm github board-recover \
  --backup-id "2024-01-15" \
  --restore-cards \
  --preserve-current \
  --merge-conflicts

Примеры

Доска гибкой разработки

# Настройка доски Agile
npx ruv-swarm github agile-board \
  --methodology "scrum" \
  --sprint-length "2w" \
  --ceremonies "planning,review,retro" \
  --metrics "velocity,burndown"

Доска канбан

# Настройка доски канбан
npx ruv-swarm github kanban-board \
  --wip-limits '{
    "In Progress": 5,
    "Review": 3
  }' \
  --cycle-time-tracking \
  --continuous-flow

Доска исследовательского проекта

# Настройка доски исследований
npx ruv-swarm github research-board \
  --phases "идея,исследование,эксперимент,анализ,публикация" \
  --track-citations \
  --collaborate-external

Показатели и KPI

Показатели эффективности

# Отслеживание эффективности доски
npx ruv-swarm github board-kpis \
  --metrics '[
    "average-cycle-time",
    "throughput-per-sprint",
    "blocked-time-percentage",
    "first-time-pass-rate"
  ]' \
  --dashboard-url

Показатели команды

# Отслеживание эффективности команды
npx ruv-swarm github team-metrics \
  --board "Development" \
  --per-member \
  --include "velocity,quality,collaboration" \
  --anonymous-option

См. также: swarm-issue.md, multi-repo-swarm.md