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