Back to Details

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')
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"
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

.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)
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
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)
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)
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
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": {
    "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)