name: project-board-sync description: Synchronize AI swarms with GitHub Projects for visual task management, progress tracking, and team coordination type: coordination color: "#A8E6CF" tools:

Bash
Read
Write
Edit
Glob
Grep
LS
TodoWrite
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_issue_track
mcp__claude-flow__github_metrics
mcp__claude-flow__workflow_create
mcp__claude-flow__workflow_execute hooks: pre:
- "gh auth status || (echo 'GitHub CLI not authenticated' && exit 1)"
- "gh project list --owner @me --limit 1 >$dev$null || echo 'No projects accessible'"
- "git status --porcelain || echo 'Not in git repository'"
- "gh api user | jq -r '.login' || echo 'API access check'" post:
- "gh project list --owner @me --limit 3 | head -5"
- "gh issue list --limit 3 --json number,title,state"
- "git branch --show-current || echo 'Not on a branch'"
- "gh repo view --json name,description"

name: project-board-sync description: 将AI集群与GitHub Projects同步，实现可视化任务管理、进度跟踪和团队协作 type: 协作 color: "#A8E6CF" tools:

Bash
Read
Write
Edit
Glob
Grep
LS
TodoWrite
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_issue_track
mcp__claude-flow__github_metrics
mcp__claude-flow__workflow_create
mcp__claude-flow__workflow_execute hooks: pre:
- "gh auth status || (echo 'GitHub CLI not authenticated' && exit 1)"
- "gh project list --owner @me --limit 1 >$dev$null || echo 'No projects accessible'"
- "git status --porcelain || echo 'Not in git repository'"
- "gh api user | jq -r '.login' || echo 'API access check'" post:
- "gh project list --owner @me --limit 3 | head -5"
- "gh issue list --limit 3 --json number,title,state"
- "git branch --show-current || echo 'Not on a branch'"
- "gh repo view --json name,description"

Project Board Sync - GitHub Projects Integration

项目看板同步 - GitHub Projects集成

Overview

概述

Synchronize AI swarms with GitHub Projects for visual task management, progress tracking, and team coordination.

将AI集群与GitHub Projects同步，实现可视化任务管理、进度跟踪和团队协作。

Core Features

核心功能

1. Board Initialization

1. 看板初始化

bash

undefined

bash

undefined

Connect swarm to GitHub Project using gh CLI

Get project details

PROJECT_ID=$(gh project list --owner @me --format json |
jq -r '.projects[] | select(.title == "Development Board") | .id')

Initialize swarm with project

npx ruv-swarm github board-init
--project-id "$PROJECT_ID"
--sync-mode "bidirectional"
--create-views "swarm-status,agent-workload,priority"

Create project fields for swarm tracking

gh project field-create $PROJECT_ID --owner @me
--name "Swarm Status"
--data-type "SINGLE_SELECT"
--single-select-options "pending,in_progress,completed"

undefined

gh project field-create $PROJECT_ID --owner @me
--name "Swarm Status"
--data-type "SINGLE_SELECT"
--single-select-options "pending,in_progress,completed"

undefined

2. Task Synchronization

2. 任务同步

bash

undefined

bash

undefined

Sync swarm tasks with project cards

npx ruv-swarm github board-sync
--map-status '{ "todo": "To Do", "in_progress": "In Progress", "review": "Review", "done": "Done" }'
--auto-move-cards
--update-metadata

undefined

npx ruv-swarm github board-sync
--map-status '{ "todo": "To Do", "in_progress": "In Progress", "review": "Review", "done": "Done" }'
--auto-move-cards
--update-metadata

undefined

3. Real-time Updates

3. 实时更新

bash

undefined

bash

undefined

Enable real-time board updates

npx ruv-swarm github board-realtime
--webhook-endpoint "https:/$api.example.com$github-sync"
--update-frequency "immediate"
--batch-updates false

undefined

npx ruv-swarm github board-realtime
--webhook-endpoint "https:/$api.example.com$github-sync"
--update-frequency "immediate"
--batch-updates false

undefined

Configuration

配置

Board Mapping Configuration

看板映射配置

yaml

undefined

yaml

undefined

.github$board-sync.yml

version: 1 project: name: "AI Development Board" number: 1

mapping:

Map swarm task status to board columns

status: pending: "Backlog" assigned: "Ready" in_progress: "In Progress" review: "Review" completed: "Done" blocked: "Blocked"

Map agent types to labels

agents: coder: "🔧 Development" tester: "🧪 Testing" analyst: "📊 Analysis" designer: "🎨 Design" architect: "🏗️ Architecture"

Map priority to project fields

priority: critical: "🔴 Critical" high: "🟡 High" medium: "🟢 Medium" low: "⚪ Low"

Custom fields

fields: - name: "Agent Count" type: number source: task.agents.length - name: "Complexity" type: select source: task.complexity - name: "ETA" type: date source: task.estimatedCompletion

undefined

version: 1 project: name: "AI Development Board" number: 1

mapping:

Map swarm task status to board columns

status: pending: "Backlog" assigned: "Ready" in_progress: "In Progress" review: "Review" completed: "Done" blocked: "Blocked"

Map agent types to labels

agents: coder: "🔧 Development" tester: "🧪 Testing" analyst: "📊 Analysis" designer: "🎨 Design" architect: "🏗️ Architecture"

Map priority to project fields

priority: critical: "🔴 Critical" high: "🟡 High" medium: "🟢 Medium" low: "⚪ Low"

Custom fields

fields: - name: "Agent Count" type: number source: task.agents.length - name: "Complexity" type: select source: task.complexity - name: "ETA" type: date source: task.estimatedCompletion

undefined

View Configuration

视图配置

javascript

// Custom board views
{
  "views": [
    {
      "name": "Swarm Overview",
      "type": "board",
      "groupBy": "status",
      "filters": ["is:open"],
      "sort": "priority:desc"
    },
    {
      "name": "Agent Workload",
      "type": "table",
      "groupBy": "assignedAgent",
      "columns": ["title", "status", "priority", "eta"],
      "sort": "eta:asc"
    },
    {
      "name": "Sprint Progress",
      "type": "roadmap",
      "dateField": "eta",
      "groupBy": "milestone"
    }
  ]
}

javascript

// Custom board views
{
  "views": [
    {
      "name": "Swarm Overview",
      "type": "board",
      "groupBy": "status",
      "filters": ["is:open"],
      "sort": "priority:desc"
    },
    {
      "name": "Agent Workload",
      "type": "table",
      "groupBy": "assignedAgent",
      "columns": ["title", "status", "priority", "eta"],
      "sort": "eta:asc"
    },
    {
      "name": "Sprint Progress",
      "type": "roadmap",
      "dateField": "eta",
      "groupBy": "milestone"
    }
  ]
}

Automation Features

自动化功能

1. Auto-Assignment

1. 自动分配

bash

undefined

bash

undefined

Automatically assign cards to agents

npx ruv-swarm github board-auto-assign
--strategy "load-balanced"
--consider "expertise,workload,availability"
--update-cards

undefined

npx ruv-swarm github board-auto-assign
--strategy "load-balanced"
--consider "expertise,workload,availability"
--update-cards

undefined

2. Progress Tracking

2. 进度跟踪

bash

undefined

bash

undefined

Track and visualize progress

npx ruv-swarm github board-progress
--show "burndown,velocity,cycle-time"
--time-period "sprint"
--export-metrics

undefined

npx ruv-swarm github board-progress
--show "burndown,velocity,cycle-time"
--time-period "sprint"
--export-metrics

undefined

3. Smart Card Movement

3. 智能卡片移动

bash

undefined

bash

undefined

Intelligent card state transitions

npx ruv-swarm github board-smart-move
--rules '{ "auto-progress": "when:all-subtasks-done", "auto-review": "when:tests-pass", "auto-done": "when:pr-merged" }'

undefined

npx ruv-swarm github board-smart-move
--rules '{ "auto-progress": "when:all-subtasks-done", "auto-review": "when:tests-pass", "auto-done": "when:pr-merged" }'

undefined

Board Commands

看板命令

Create Cards from Issues

从Issue创建卡片

bash

undefined

bash

undefined

Convert issues to project cards using gh CLI

List issues with label

ISSUES=$(gh issue list --label "enhancement" --json number,title,body)

Add issues to project

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

Process with swarm

npx ruv-swarm github board-import-issues
--issues "$ISSUES"
--add-to-column "Backlog"
--parse-checklist
--assign-agents

undefined

npx ruv-swarm github board-import-issues
--issues "$ISSUES"
--add-to-column "Backlog"
--parse-checklist
--assign-agents

undefined

Bulk Operations

批量操作

bash

undefined

bash

undefined

Bulk card operations

npx ruv-swarm github board-bulk
--filter "status:blocked"
--action "add-label:needs-attention"
--notify-assignees

undefined

npx ruv-swarm github board-bulk
--filter "status:blocked"
--action "add-label:needs-attention"
--notify-assignees

undefined

Card Templates

卡片模板

bash

undefined

bash

undefined

Create cards from templates

npx ruv-swarm github board-template
--template "feature-development"
--variables '{ "feature": "User Authentication", "priority": "high", "agents": ["architect", "coder", "tester"] }'
--create-subtasks

undefined

npx ruv-swarm github board-template
--template "feature-development"
--variables '{ "feature": "User Authentication", "priority": "high", "agents": ["architect", "coder", "tester"] }'
--create-subtasks

undefined

Advanced Synchronization

高级同步

1. Multi-Board Sync

1. 多看板同步

bash

undefined

bash

undefined

Sync across multiple boards

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

undefined

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

undefined

2. Cross-Organization Sync

2. 跨组织同步

bash

undefined

bash

undefined

Sync boards across organizations

npx ruv-swarm github cross-org-sync
--source "org1/Project-A"
--target "org2/Project-B"
--field-mapping "custom"
--conflict-resolution "source-wins"

undefined

npx ruv-swarm github cross-org-sync
--source "org1/Project-A"
--target "org2/Project-B"
--field-mapping "custom"
--conflict-resolution "source-wins"

undefined

3. External Tool Integration

3. 外部工具集成

bash

undefined

bash

undefined

Sync with external tools

npx ruv-swarm github board-integrate
--tool "jira"
--mapping "bidirectional"
--sync-frequency "5m"
--transform-rules "custom"

undefined

npx ruv-swarm github board-integrate
--tool "jira"
--mapping "bidirectional"
--sync-frequency "5m"
--transform-rules "custom"

undefined

Visualization & Reporting

可视化与报告

Board Analytics

看板分析

bash

undefined

bash

undefined

Generate board analytics using gh CLI data

Fetch project data

PROJECT_DATA=$(gh project item-list $PROJECT_ID --owner @me --format json)

Get issue metrics

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)

Generate analytics with 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"

undefined

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"

undefined

Custom Dashboards

自定义仪表板

javascript

// Dashboard configuration
{
  "dashboard": {
    "widgets": [
      {
        "type": "chart",
        "title": "Task Completion Rate",
        "data": "completed-per-day",
        "visualization": "line"
      },
      {
        "type": "gauge",
        "title": "Sprint Progress",
        "data": "sprint-completion",
        "target": 100
      },
      {
        "type": "heatmap",
        "title": "Agent Activity",
        "data": "agent-tasks-per-day"
      }
    ]
  }
}

javascript

// Dashboard configuration
{
  "dashboard": {
    "widgets": [
      {
        "type": "chart",
        "title": "Task Completion Rate",
        "data": "completed-per-day",
        "visualization": "line"
      },
      {
        "type": "gauge",
        "title": "Sprint Progress",
        "data": "sprint-completion",
        "target": 100
      },
      {
        "type": "heatmap",
        "title": "Agent Activity",
        "data": "agent-tasks-per-day"
      }
    ]
  }
}

Reports

报告

bash

undefined

bash

undefined

Generate reports

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

undefined

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

undefined

Workflow Integration

工作流集成

Sprint Management

迭代管理

bash

undefined

bash

undefined

Manage sprints with swarms

npx ruv-swarm github sprint-manage
--sprint "Sprint 23"
--auto-populate
--capacity-planning
--track-velocity

undefined

npx ruv-swarm github sprint-manage
--sprint "Sprint 23"
--auto-populate
--capacity-planning
--track-velocity

undefined

Milestone Tracking

里程碑跟踪

bash

undefined

bash

undefined

Track milestone progress

npx ruv-swarm github milestone-track
--milestone "v2.0 Release"
--update-board
--show-dependencies
--predict-completion

undefined

npx ruv-swarm github milestone-track
--milestone "v2.0 Release"
--update-board
--show-dependencies
--predict-completion

undefined

Release Planning

发布规划

bash

undefined

bash

undefined

Plan releases using board data

npx ruv-swarm github release-plan-board
--analyze-velocity
--estimate-completion
--identify-risks
--optimize-scope

undefined

npx ruv-swarm github release-plan-board
--analyze-velocity
--estimate-completion
--identify-risks
--optimize-scope

undefined

Team Collaboration

团队协作

Work Distribution

工作分配

bash

undefined

bash

undefined

Distribute work among team

npx ruv-swarm github board-distribute
--strategy "skills-based"
--balance-workload
--respect-preferences
--notify-assignments

undefined

npx ruv-swarm github board-distribute
--strategy "skills-based"
--balance-workload
--respect-preferences
--notify-assignments

undefined

Standup Automation

站会自动化

bash

undefined

bash

undefined

Generate standup reports

npx ruv-swarm github standup-report
--team "frontend"
--include "yesterday,today,blockers"
--format "slack"
--schedule "daily-9am"

undefined

npx ruv-swarm github standup-report
--team "frontend"
--include "yesterday,today,blockers"
--format "slack"
--schedule "daily-9am"

undefined

Review Coordination

评审协作

bash

undefined

bash

undefined

Coordinate reviews via board

npx ruv-swarm github review-coordinate
--board "Code Review"
--assign-reviewers
--track-feedback
--ensure-coverage

undefined

npx ruv-swarm github review-coordinate
--board "Code Review"
--assign-reviewers
--track-feedback
--ensure-coverage

undefined

Best Practices

最佳实践

1. Board Organization

1. 看板组织

Clear column definitions
Consistent labeling system
Regular board grooming
Automation rules

清晰的列定义
一致的标签系统
定期看板梳理
自动化规则

2. Data Integrity

2. 数据完整性

Bidirectional sync validation
Conflict resolution strategies
Audit trails
Regular backups

双向同步验证
冲突解决策略
审计追踪
定期备份

3. Team Adoption

3. 团队采用

Training materials
Clear workflows
Regular reviews
Feedback loops

培训材料
清晰的工作流
定期回顾
反馈循环

Troubleshooting

故障排除

Sync Issues

同步问题

bash

undefined

bash

undefined

Diagnose sync problems

npx ruv-swarm github board-diagnose
--check "permissions,webhooks,rate-limits"
--test-sync
--show-conflicts

undefined

npx ruv-swarm github board-diagnose
--check "permissions,webhooks,rate-limits"
--test-sync
--show-conflicts

undefined

Performance

性能优化

bash

undefined

bash

undefined

Optimize board performance

npx ruv-swarm github board-optimize
--analyze-size
--archive-completed
--index-fields
--cache-views

undefined

npx ruv-swarm github board-optimize
--analyze-size
--archive-completed
--index-fields
--cache-views

undefined

Data Recovery

数据恢复

bash

undefined

bash

undefined

Recover board data

npx ruv-swarm github board-recover
--backup-id "2024-01-15"
--restore-cards
--preserve-current
--merge-conflicts

undefined

npx ruv-swarm github board-recover
--backup-id "2024-01-15"
--restore-cards
--preserve-current
--merge-conflicts

undefined

Examples

示例

Agile Development Board

敏捷开发看板

bash

undefined

bash

undefined

Setup agile board

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

undefined

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

undefined

Kanban Flow Board

看板流（Kanban）看板

bash

undefined

bash

undefined

Setup kanban board

npx ruv-swarm github kanban-board
--wip-limits '{ "In Progress": 5, "Review": 3 }'
--cycle-time-tracking
--continuous-flow

undefined

npx ruv-swarm github kanban-board
--wip-limits '{ "In Progress": 5, "Review": 3 }'
--cycle-time-tracking
--continuous-flow

undefined

Research Project Board

研究项目看板

bash

undefined

bash

undefined

Setup research board

npx ruv-swarm github research-board
--phases "ideation,research,experiment,analysis,publish"
--track-citations
--collaborate-external

undefined

npx ruv-swarm github research-board
--phases "ideation,research,experiment,analysis,publish"
--track-citations
--collaborate-external

undefined

Metrics & KPIs

指标与KPI

Performance Metrics

性能指标

bash

undefined

bash

undefined

Track board performance

npx ruv-swarm github board-kpis
--metrics '[ "average-cycle-time", "throughput-per-sprint", "blocked-time-percentage", "first-time-pass-rate" ]'
--dashboard-url

undefined

npx ruv-swarm github board-kpis
--metrics '[ "average-cycle-time", "throughput-per-sprint", "blocked-time-percentage", "first-time-pass-rate" ]'
--dashboard-url

undefined

Team Metrics

团队指标

bash

undefined

bash

undefined

Track team performance

npx ruv-swarm github team-metrics
--board "Development"
--per-member
--include "velocity,quality,collaboration"
--anonymous-option


See also: [swarm-issue.md](.$swarm-issue.md), [multi-repo-swarm.md](.$multi-repo-swarm.md)

npx ruv-swarm github team-metrics
--board "Development"
--per-member
--include "velocity,quality,collaboration"
--anonymous-option


另请参阅：[swarm-issue.md](.$swarm-issue.md), [multi-repo-swarm.md](.$multi-repo-swarm.md)

agent-project-board-sync

Original

Translation

Project Board Sync - GitHub Projects Integration

项目看板同步 - GitHub Projects集成

Overview

概述

Core Features

核心功能

1. Board Initialization

1. 看板初始化

Connect swarm to GitHub Project using gh CLI

Connect swarm to GitHub Project using gh CLI

Get project details

Get project details

Initialize swarm with project

Initialize swarm with project

Create project fields for swarm tracking

Create project fields for swarm tracking

2. Task Synchronization

2. 任务同步

Sync swarm tasks with project cards

Sync swarm tasks with project cards

3. Real-time Updates

3. 实时更新

Enable real-time board updates

Enable real-time board updates

Configuration

配置

Board Mapping Configuration

看板映射配置

.github$board-sync.yml

.github$board-sync.yml

Map swarm task status to board columns

Map agent types to labels

Map priority to project fields

Custom fields

Map swarm task status to board columns

Map agent types to labels

Map priority to project fields

Custom fields

View Configuration

视图配置

Automation Features

自动化功能

1. Auto-Assignment

1. 自动分配

Automatically assign cards to agents

Automatically assign cards to agents

2. Progress Tracking

2. 进度跟踪

Track and visualize progress

Track and visualize progress

3. Smart Card Movement

3. 智能卡片移动

Intelligent card state transitions

Intelligent card state transitions

Board Commands

看板命令

Create Cards from Issues

从Issue创建卡片

Convert issues to project cards using gh CLI

Convert issues to project cards using gh CLI

List issues with label

List issues with label

Add issues to project

Add issues to project

Process with swarm

Process with swarm

Bulk Operations

批量操作

Bulk card operations

Bulk card operations

Card Templates

卡片模板

Create cards from templates

Create cards from templates

Advanced Synchronization

高级同步

1. Multi-Board Sync