agent-project-board-sync

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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 swarms与GitHub Projects同步，实现可视化任务管理、进度跟踪和团队协作 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未认证' && 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"

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 swarms与GitHub Projects同步，实现可视化任务管理、进度跟踪和团队协作。

Core Features

核心功能

1. Board Initialization

1. 项目板初始化

bash

undefined

bash

undefined

Connect swarm to GitHub Project using gh CLI

使用gh CLI将swarm连接到GitHub Project

Get project details

获取项目详情

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

Initialize swarm with project

用项目初始化swarm

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

创建用于swarm跟踪的项目字段

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

将swarm任务与项目卡片同步

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开发板" number: 1

mapping:

将swarm任务状态映射到项目板列

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

将Agent类型映射到标签

agents: coder: "🔧 开发" tester: "🧪 测试" analyst: "📊 分析" designer: "🎨 设计" architect: "🏗️ 架构"

将优先级映射到项目字段

priority: critical: "🔴 紧急" high: "🟡 高" medium: "🟢 中" low: "⚪ 低"

自定义字段

fields: - name: "Agent数量" type: number source: task.agents.length - name: "复杂度" type: select source: task.complexity - name: "预计完成时间" 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

// 自定义项目板视图
{
  "views": [
    {
      "name": "Swarm总览",
      "type": "board",
      "groupBy": "status",
      "filters": ["is:open"],
      "sort": "priority:desc"
    },
    {
      "name": "Agent工作量",
      "type": "table",
      "groupBy": "assignedAgent",
      "columns": ["title", "status", "priority", "eta"],
      "sort": "eta:asc"
    },
    {
      "name": "迭代进度",
      "type": "roadmap",
      "dateField": "eta",
      "groupBy": "milestone"
    }
  ]
}

Automation Features

自动化功能

1. Auto-Assignment

1. 自动分配

bash

undefined

bash

undefined

Automatically assign cards to agents

自动将卡片分配给Agent

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

使用gh CLI将Issue转换为项目卡片

List issues with label

列出带指定标签的Issue

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

Add issues to project

将Issue添加到项目

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

用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": "用户认证", "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

使用gh CLI数据生成项目板分析

Fetch project data

获取项目数据

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

Get issue metrics

获取Issue指标

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

用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

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": {
    "widgets": [
      {
        "type": "chart",
        "title": "任务完成率",
        "data": "completed-per-day",
        "visualization": "line"
      },
      {
        "type": "gauge",
        "title": "迭代进度",
        "data": "sprint-completion",
        "target": 100
      },
      {
        "type": "heatmap",
        "title": "Agent活动情况",
        "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

用swarm管理迭代

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

看板流项目板

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)