Agent Project Board Sync

作者 ruvnet6051f6702b61無授權條款74K 個星標收錄於 2026年10月8日更新於 2026年10月8日儲存庫今天更新

Agent skill for project-board-sync - invoke with $agent-project-board-sync

僅含說明Productivity & Workflow AI & Agents

AI 產生的概覽

將 AI 代理集群與 GitHub Projects 看板同步，用於任務追蹤、進度回報與團隊協作。

功能: 此技能提供將 AI 集群連接到 GitHub Projects 的說明，讓任務狀態、優先順序與代理指派能與看板欄位保持同步。內容涵蓋看板初始化、雙向任務同步、自動指派、卡片智慧流轉、多看板與跨組織同步，以及與 Jira 等外部工具的整合。它也說明分析、儀表板、衝刺與里程碑追蹤、站立會議報告與疑難排解指令，主要以 gh CLI 與 npx ruv-swarm 指令範例及 YAML、JSON 設定呈現。
適用情境: 當你希望代理產出的工作項目反映在 GitHub Projects 看板上，或希望由看板狀態驅動代理任務指派與進度追蹤時使用。它也適合需要衝刺、里程碑或發布報告，並在多個看板或組織之間協調的團隊。
執行需求: 需要已通過驗證並具備專案存取權限的 GitHub CLI（gh）、git、jq，以及指令中引用的 npx ruv-swarm 工具。它也引用 claude-flow 的 MCP 工具，用於集群初始化、代理生成、任務編排與 GitHub 操作。需要存取 GitHub 及所整合外部工具的網路。此技能不附帶指令碼，僅為說明文件。

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"

Project Board Sync - GitHub Projects Integration

Overview

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

Core Features

1. Board Initialization

bash

# Connect swarm to GitHub Project using gh CLI# Get project detailsPROJECT_ID=$(gh project list --owner @me --format json | \  jq -r '.projects[] | select(.title == "Development Board") | .id')
# Initialize swarm with projectnpx ruv-swarm github board-init \  --project-id "$PROJECT_ID" \  --sync-mode "bidirectional" \  --create-views "swarm-status,agent-workload,priority"
# Create project fields for swarm trackinggh project field-create $PROJECT_ID --owner @me \  --name "Swarm Status" \  --data-type "SINGLE_SELECT" \  --single-select-options "pending,in_progress,completed"

# Connect swarm to GitHub Project using gh CLI# Get project detailsPROJECT_ID=$(gh project list --owner @me --format json | \  jq -r '.projects[] | select(.title == "Development Board") | .id')
# Initialize swarm with projectnpx ruv-swarm github board-init \  --project-id "$PROJECT_ID" \  --sync-mode "bidirectional" \  --create-views "swarm-status,agent-workload,priority"
# Create project fields for swarm trackinggh project field-create $PROJECT_ID --owner @me \  --name "Swarm Status" \  --data-type "SINGLE_SELECT" \  --single-select-options "pending,in_progress,completed"

2. Task Synchronization

bash

# Sync swarm tasks with project cardsnpx ruv-swarm github board-sync \  --map-status '{    "todo": "To Do",    "in_progress": "In Progress",    "review": "Review",    "done": "Done"  }' \  --auto-move-cards \  --update-metadata

# Sync swarm tasks with project cardsnpx ruv-swarm github board-sync \  --map-status '{    "todo": "To Do",    "in_progress": "In Progress",    "review": "Review",    "done": "Done"  }' \  --auto-move-cards \  --update-metadata

3. Real-time Updates

bash

# Enable real-time board updatesnpx ruv-swarm github board-realtime \  --webhook-endpoint "https:/$api.example.com$github-sync" \  --update-frequency "immediate" \  --batch-updates false

# Enable real-time board updatesnpx ruv-swarm github board-realtime \  --webhook-endpoint "https:/$api.example.com$github-sync" \  --update-frequency "immediate" \  --batch-updates false

Configuration

Board Mapping Configuration

yaml

# .github$board-sync.ymlversion: 1project:  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

# .github$board-sync.ymlversion: 1project:  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

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"    }  ]}

// 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

bash

# Automatically assign cards to agentsnpx ruv-swarm github board-auto-assign \  --strategy "load-balanced" \  --consider "expertise,workload,availability" \  --update-cards

# Automatically assign cards to agentsnpx ruv-swarm github board-auto-assign \  --strategy "load-balanced" \  --consider "expertise,workload,availability" \  --update-cards

2. Progress Tracking

bash

# Track and visualize progressnpx ruv-swarm github board-progress \  --show "burndown,velocity,cycle-time" \  --time-period "sprint" \  --export-metrics

# Track and visualize progressnpx ruv-swarm github board-progress \  --show "burndown,velocity,cycle-time" \  --time-period "sprint" \  --export-metrics

3. Smart Card Movement

bash

# Intelligent card state transitionsnpx ruv-swarm github board-smart-move \  --rules '{    "auto-progress": "when:all-subtasks-done",    "auto-review": "when:tests-pass",    "auto-done": "when:pr-merged"  }'

# Intelligent card state transitionsnpx ruv-swarm github board-smart-move \  --rules '{    "auto-progress": "when:all-subtasks-done",    "auto-review": "when:tests-pass",    "auto-done": "when:pr-merged"  }'

Board Commands

Create Cards from Issues

bash

# Convert issues to project cards using gh CLI# List issues with labelISSUES=$(gh issue list --label "enhancement" --json number,title,body)
# Add issues to projectecho "$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 swarmnpx ruv-swarm github board-import-issues \  --issues "$ISSUES" \  --add-to-column "Backlog" \  --parse-checklist \  --assign-agents

# Convert issues to project cards using gh CLI# List issues with labelISSUES=$(gh issue list --label "enhancement" --json number,title,body)
# Add issues to projectecho "$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 swarmnpx ruv-swarm github board-import-issues \  --issues "$ISSUES" \  --add-to-column "Backlog" \  --parse-checklist \  --assign-agents

Bulk Operations

bash

# Bulk card operationsnpx ruv-swarm github board-bulk \  --filter "status:blocked" \  --action "add-label:needs-attention" \  --notify-assignees

# Bulk card operationsnpx ruv-swarm github board-bulk \  --filter "status:blocked" \  --action "add-label:needs-attention" \  --notify-assignees

Card Templates

bash

# Create cards from templatesnpx ruv-swarm github board-template \  --template "feature-development" \  --variables '{    "feature": "User Authentication",    "priority": "high",    "agents": ["architect", "coder", "tester"]  }' \  --create-subtasks

# Create cards from templatesnpx ruv-swarm github board-template \  --template "feature-development" \  --variables '{    "feature": "User Authentication",    "priority": "high",    "agents": ["architect", "coder", "tester"]  }' \  --create-subtasks

Advanced Synchronization

1. Multi-Board Sync

bash

# Sync across multiple boardsnpx ruv-swarm github multi-board-sync \  --boards "Development,QA,Release" \  --sync-rules '{    "Development->QA": "when:ready-for-test",    "QA->Release": "when:tests-pass"  }'

# Sync across multiple boardsnpx ruv-swarm github multi-board-sync \  --boards "Development,QA,Release" \  --sync-rules '{    "Development->QA": "when:ready-for-test",    "QA->Release": "when:tests-pass"  }'

2. Cross-Organization Sync

bash

# Sync boards across organizationsnpx ruv-swarm github cross-org-sync \  --source "org1/Project-A" \  --target "org2/Project-B" \  --field-mapping "custom" \  --conflict-resolution "source-wins"

# Sync boards across organizationsnpx ruv-swarm github cross-org-sync \  --source "org1/Project-A" \  --target "org2/Project-B" \  --field-mapping "custom" \  --conflict-resolution "source-wins"

3. External Tool Integration

bash

# Sync with external toolsnpx ruv-swarm github board-integrate \  --tool "jira" \  --mapping "bidirectional" \  --sync-frequency "5m" \  --transform-rules "custom"

# Sync with external toolsnpx ruv-swarm github board-integrate \  --tool "jira" \  --mapping "bidirectional" \  --sync-frequency "5m" \  --transform-rules "custom"

Visualization & Reporting

Board Analytics

bash

# Generate board analytics using gh CLI data# Fetch project dataPROJECT_DATA=$(gh project item-list $PROJECT_ID --owner @me --format json)
# Get issue metricsISSUE_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 swarmnpx 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"

# Generate board analytics using gh CLI data# Fetch project dataPROJECT_DATA=$(gh project item-list $PROJECT_ID --owner @me --format json)
# Get issue metricsISSUE_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 swarmnpx 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"

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"      }    ]  }}

// 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

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

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

Workflow Integration

Sprint Management

bash

# Manage sprints with swarmsnpx ruv-swarm github sprint-manage \  --sprint "Sprint 23" \  --auto-populate \  --capacity-planning \  --track-velocity

# Manage sprints with swarmsnpx ruv-swarm github sprint-manage \  --sprint "Sprint 23" \  --auto-populate \  --capacity-planning \  --track-velocity

Milestone Tracking

bash

# Track milestone progressnpx ruv-swarm github milestone-track \  --milestone "v2.0 Release" \  --update-board \  --show-dependencies \  --predict-completion

# Track milestone progressnpx ruv-swarm github milestone-track \  --milestone "v2.0 Release" \  --update-board \  --show-dependencies \  --predict-completion

Release Planning

bash

# Plan releases using board datanpx ruv-swarm github release-plan-board \  --analyze-velocity \  --estimate-completion \  --identify-risks \  --optimize-scope

# Plan releases using board datanpx ruv-swarm github release-plan-board \  --analyze-velocity \  --estimate-completion \  --identify-risks \  --optimize-scope

Team Collaboration

Work Distribution

bash

# Distribute work among teamnpx ruv-swarm github board-distribute \  --strategy "skills-based" \  --balance-workload \  --respect-preferences \  --notify-assignments

# Distribute work among teamnpx ruv-swarm github board-distribute \  --strategy "skills-based" \  --balance-workload \  --respect-preferences \  --notify-assignments

Standup Automation

bash

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

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

Review Coordination

bash

# Coordinate reviews via boardnpx ruv-swarm github review-coordinate \  --board "Code Review" \  --assign-reviewers \  --track-feedback \  --ensure-coverage

# Coordinate reviews via boardnpx ruv-swarm github review-coordinate \  --board "Code Review" \  --assign-reviewers \  --track-feedback \  --ensure-coverage

Best Practices

1. Board Organization

Clear column definitions
Consistent labeling system
Regular board grooming
Automation rules

2. Data Integrity

Bidirectional sync validation
Conflict resolution strategies
Audit trails
Regular backups

3. Team Adoption

Training materials
Clear workflows
Regular reviews
Feedback loops

Troubleshooting

Sync Issues

bash

# Diagnose sync problemsnpx ruv-swarm github board-diagnose \  --check "permissions,webhooks,rate-limits" \  --test-sync \  --show-conflicts

# Diagnose sync problemsnpx ruv-swarm github board-diagnose \  --check "permissions,webhooks,rate-limits" \  --test-sync \  --show-conflicts

Performance

bash

# Optimize board performancenpx ruv-swarm github board-optimize \  --analyze-size \  --archive-completed \  --index-fields \  --cache-views

# Optimize board performancenpx ruv-swarm github board-optimize \  --analyze-size \  --archive-completed \  --index-fields \  --cache-views

Data Recovery

bash

# Recover board datanpx ruv-swarm github board-recover \  --backup-id "2024-01-15" \  --restore-cards \  --preserve-current \  --merge-conflicts

# Recover board datanpx ruv-swarm github board-recover \  --backup-id "2024-01-15" \  --restore-cards \  --preserve-current \  --merge-conflicts

Examples

Agile Development Board

bash

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

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

Kanban Flow Board

bash

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

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

Research Project Board

bash

# Setup research boardnpx ruv-swarm github research-board \  --phases "ideation,research,experiment,analysis,publish" \  --track-citations \  --collaborate-external

# Setup research boardnpx ruv-swarm github research-board \  --phases "ideation,research,experiment,analysis,publish" \  --track-citations \  --collaborate-external

Metrics & KPIs

Performance Metrics

bash

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

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

Team Metrics

bash

# Track team performancenpx ruv-swarm github team-metrics \  --board "Development" \  --per-member \  --include "velocity,quality,collaboration" \  --anonymous-option

# Track team performancenpx ruv-swarm github team-metrics \  --board "Development" \  --per-member \  --include "velocity,quality,collaboration" \  --anonymous-option

See also: swarm-issue.md [blocked], multi-repo-swarm.md [blocked]

來源與署名

來源：ruvnet/ruflo位於.agents/skills/agent-project-board-sync提交6051f67

授權條款：無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

Agent Project Board Sync

Project Board Sync - GitHub Projects Integration

Overview

Core Features

1. Board Initialization

2. Task Synchronization

3. Real-time Updates

Configuration

Board Mapping Configuration

View Configuration

Automation Features

1. Auto-Assignment

2. Progress Tracking

3. Smart Card Movement

Board Commands

Create Cards from Issues

Bulk Operations

Card Templates

Advanced Synchronization

1. Multi-Board Sync

2. Cross-Organization Sync

3. External Tool Integration

Visualization & Reporting

Board Analytics

Custom Dashboards

Reports

Workflow Integration

Sprint Management

Milestone Tracking

Release Planning

Team Collaboration

Work Distribution

Standup Automation

Review Coordination

Best Practices

1. Board Organization

2. Data Integrity

3. Team Adoption

Troubleshooting

Sync Issues

Performance

Data Recovery

Examples

Agile Development Board

Kanban Flow Board

Research Project Board

Metrics & KPIs

Performance Metrics

Team Metrics

來源與署名

更多來自 ruvnet/ruflo 的技能

Cron Schedule

Autopilot Predict

Autopilot Loop

Worker Integration

Worker Benchmarks

Swarm Advanced

更多Productivity & Workflow技能

Dd Meeting Prep

Dd Checklist

Deal Tracker

Client Review

Morning Note

Notion Spec To Implementation