Back to Details

github-project-management

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

GitHub Project Management

GitHub项目管理

Overview

概述

A comprehensive skill for managing GitHub projects using AI swarm coordination. This skill combines intelligent issue management, automated project board synchronization, and swarm-based coordination for efficient project delivery.
这是一个利用AI Swarm协作来管理GitHub项目的全能工具，结合了智能问题管理、自动化项目看板同步以及基于Swarm的协作，以实现高效的项目交付。

Quick Start

快速开始

Basic Issue Creation with Swarm Coordination

基于Swarm协作的基础问题创建

bash
undefined
bash
undefined

Create a coordinated issue

创建协作式问题

gh issue create
--title "Feature: Advanced Authentication"
--body "Implement OAuth2 with social login..."
--label "enhancement,swarm-ready"
gh issue create
--title "Feature: Advanced Authentication"
--body "Implement OAuth2 with social login..."
--label "enhancement,swarm-ready"

Initialize swarm for issue

为问题初始化Swarm

npx claude-flow@alpha hooks pre-task --description "Feature implementation"
undefined
npx claude-flow@alpha hooks pre-task --description "Feature implementation"
undefined

Project Board Quick Setup

项目看板快速设置

bash
undefined
bash
undefined

Get project ID

获取项目ID

PROJECT_ID=$(gh project list --owner @me --format json |
jq -r '.projects[0].id')
PROJECT_ID=$(gh project list --owner @me --format json |
jq -r '.projects[0].id')

Initialize board sync

初始化看板同步

npx ruv-swarm github board-init
--project-id "$PROJECT_ID"
--sync-mode "bidirectional"

---
npx ruv-swarm github board-init
--project-id "$PROJECT_ID"
--sync-mode "bidirectional"

---

Core Capabilities

核心功能

1. Issue Management & Triage

1. 问题管理与分类

<details> <summary><strong>Automated Issue Creation<$strong><$summary>
<details> <summary><strong>自动化问题创建<$strong><$summary>

Single Issue with Swarm Coordination

带Swarm协作的单个问题

javascript
// Initialize issue management swarm
mcp__claude-flow__swarm_init { topology: "star", maxAgents: 3 }
mcp__claude-flow__agent_spawn { type: "coordinator", name: "Issue Coordinator" }
mcp__claude-flow__agent_spawn { type: "researcher", name: "Requirements Analyst" }
mcp__claude-flow__agent_spawn { type: "coder", name: "Implementation Planner" }

// Create comprehensive issue
mcp__github__create_issue {
  owner: "org",
  repo: "repository",
  title: "Integration Review: Complete system integration",
  body: `## 🔄 Integration Review

  ### Overview
  Comprehensive review and integration between components.

  ### Objectives
  - [ ] Verify dependencies and imports
  - [ ] Ensure API integration
  - [ ] Check hook system integration
  - [ ] Validate data systems alignment

  ### Swarm Coordination
  This issue will be managed by coordinated swarm agents for optimal progress tracking.`,
  labels: ["integration", "review", "enhancement"],
  assignees: ["username"]
}

// Set up automated tracking
mcp__claude-flow__task_orchestrate {
  task: "Monitor and coordinate issue progress with automated updates",
  strategy: "adaptive",
  priority: "medium"
}
javascript
// 初始化问题管理Swarm
mcp__claude-flow__swarm_init { topology: "star", maxAgents: 3 }
mcp__claude-flow__agent_spawn { type: "coordinator", name: "Issue Coordinator" }
mcp__claude-flow__agent_spawn { type: "researcher", name: "Requirements Analyst" }
mcp__claude-flow__agent_spawn { type: "coder", name: "Implementation Planner" }

// 创建完整的问题
mcp__github__create_issue {
  owner: "org",
  repo: "repository",
  title: "Integration Review: Complete system integration",
  body: `## 🔄 集成评审

  ### 概述
  组件间的全面评审与集成。

  ### 目标
  - [ ] 验证依赖与导入
  - [ ] 确保API集成
  - [ ] 检查钩子系统集成
  - [ ] 验证数据系统对齐

  ### Swarm协作
  此问题将由协作式Swarm Agent管理，以实现最优进度追踪。`,
  labels: ["integration", "review", "enhancement"],
  assignees: ["username"]
}

Batch Issue Creation

设置自动化追踪

bash
undefined
mcp__claude-flow__task_orchestrate { task: "Monitor and coordinate issue progress with automated updates", strategy: "adaptive", priority: "medium" }
undefined

Create multiple related issues using gh CLI

批量创建问题

gh issue create
--title "Feature: Advanced GitHub Integration"
--body "Implement comprehensive GitHub workflow automation..."
--label "feature,github,high-priority"
gh issue create
--title "Bug: Merge conflicts in integration branch"
--body "Resolve merge conflicts..."
--label "bug,integration,urgent"
gh issue create
--title "Documentation: Update integration guides"
--body "Update all documentation..."
--label "documentation,integration"

<$details>

<details>
<summary><strong>Issue-to-Swarm Conversion<$strong><$summary>
bash
undefined

Transform Issues into Swarm Tasks

使用gh CLI创建多个相关问题

bash
undefined
gh issue create
--title "Feature: Advanced GitHub Integration"
--body "Implement comprehensive GitHub workflow automation..."
--label "feature,github,high-priority"
gh issue create
--title "Bug: Merge conflicts in integration branch"
--body "Resolve merge conflicts..."
--label "bug,integration,urgent"
gh issue create
--title "Documentation: Update integration guides"
--body "Update all documentation..."
--label "documentation,integration"

<$details>

<details>
<summary><strong>问题转Swarm任务<$strong><$summary>

Get issue details

将问题转换为Swarm任务

ISSUE_DATA=$(gh issue view 456 --json title,body,labels,assignees,comments)
bash
undefined

Create swarm from issue

获取问题详情

npx ruv-swarm github issue-to-swarm 456
--issue-data "$ISSUE_DATA"
--auto-decompose
--assign-agents
ISSUE_DATA=$(gh issue view 456 --json title,body,labels,assignees,comments)

Batch process multiple issues

从问题创建Swarm

ISSUES=$(gh issue list --label "swarm-ready" --json number,title,body,labels) npx ruv-swarm github issues-batch
--issues "$ISSUES"
--parallel
npx ruv-swarm github issue-to-swarm 456
--issue-data "$ISSUE_DATA"
--auto-decompose
--assign-agents

Update issues with swarm status

批量处理多个问题

echo "$ISSUES" | jq -r '.[].number' | while read -r num; do gh issue edit $num --add-label "swarm-processing" done
undefined
ISSUES=$(gh issue list --label "swarm-ready" --json number,title,body,labels) npx ruv-swarm github issues-batch
--issues "$ISSUES"
--parallel

Issue Comment Commands

更新问题的Swarm状态

Execute swarm operations via issue comments:
markdown
<!-- In issue comment -->
$swarm analyze
$swarm decompose 5
$swarm assign @agent-coder
$swarm estimate
$swarm start
<$details>
<details> <summary><strong>Automated Issue Triage<$strong><$summary>
echo "$ISSUES" | jq -r '.[].number' | while read -r num; do gh issue edit $num --add-label "swarm-processing" done
undefined

Auto-Label Based on Content

问题评论命令

javascript
// .github$swarm-labels.json
{
  "rules": [
    {
      "keywords": ["bug", "error", "broken"],
      "labels": ["bug", "swarm-debugger"],
      "agents": ["debugger", "tester"]
    },
    {
      "keywords": ["feature", "implement", "add"],
      "labels": ["enhancement", "swarm-feature"],
      "agents": ["architect", "coder", "tester"]
    },
    {
      "keywords": ["slow", "performance", "optimize"],
      "labels": ["performance", "swarm-optimizer"],
      "agents": ["analyst", "optimizer"]
    }
  ]
}
通过问题评论执行Swarm操作：
markdown
<!-- 在问题评论中 -->
$swarm analyze
$swarm decompose 5
$swarm assign @agent-coder
$swarm estimate
$swarm start
<$details>
<details> <summary><strong>自动化问题分类<$strong><$summary>

Automated Triage System

基于内容自动打标签

bash
undefined
javascript
// .github$swarm-labels.json
{
  "rules": [
    {
      "keywords": ["bug", "error", "broken"],
      "labels": ["bug", "swarm-debugger"],
      "agents": ["debugger", "tester"]
    },
    {
      "keywords": ["feature", "implement", "add"],
      "labels": ["enhancement", "swarm-feature"],
      "agents": ["architect", "coder", "tester"]
    },
    {
      "keywords": ["slow", "performance", "optimize"],
      "labels": ["performance", "swarm-optimizer"],
      "agents": ["analyst", "optimizer"]
    }
  ]
}

Analyze and triage unlabeled issues

自动化分类系统

npx ruv-swarm github triage
--unlabeled
--analyze-content
--suggest-labels
--assign-priority
bash
undefined

Find and link duplicate issues

分析并分类未打标签的问题

npx ruv-swarm github find-duplicates
--threshold 0.8
--link-related
--close-duplicates

<$details>

<details>
<summary><strong>Task Decomposition & Progress Tracking<$strong><$summary>
npx ruv-swarm github triage
--unlabeled
--analyze-content
--suggest-labels
--assign-priority

Break Down Issues into Subtasks

查找并关联重复问题

bash
undefined
npx ruv-swarm github find-duplicates
--threshold 0.8
--link-related
--close-duplicates

<$details>

<details>
<summary><strong>任务分解与进度追踪<$strong><$summary>

Get issue body

将问题拆分为子任务

ISSUE_BODY=$(gh issue view 456 --json body --jq '.body')
bash
undefined

Decompose into subtasks

获取问题内容

SUBTASKS=$(npx ruv-swarm github issue-decompose 456
--body "$ISSUE_BODY"
--max-subtasks 10
--assign-priorities)
ISSUE_BODY=$(gh issue view 456 --json body --jq '.body')

Update issue with checklist

分解为子任务

CHECKLIST=$(echo "$SUBTASKS" | jq -r '.tasks[] | "- [ ] " + .description') UPDATED_BODY="$ISSUE_BODY
SUBTASKS=$(npx ruv-swarm github issue-decompose 456
--body "$ISSUE_BODY"
--max-subtasks 10
--assign-priorities)

Subtasks

更新问题的检查清单

$CHECKLIST"
gh issue edit 456 --body "$UPDATED_BODY"
CHECKLIST=$(echo "$SUBTASKS" | jq -r '.tasks[] | "- [ ] " + .description') UPDATED_BODY="$ISSUE_BODY

Create linked issues for major subtasks

子任务

echo "$SUBTASKS" | jq -r '.tasks[] | select(.priority == "high")' | while read -r task; do TITLE=$(echo "$task" | jq -r '.title') BODY=$(echo "$task" | jq -r '.description')
gh issue create
--title "$TITLE"
--body "$BODY
Parent issue: #456"
--label "subtask" done
undefined
$CHECKLIST"
gh issue edit 456 --body "$UPDATED_BODY"

Automated Progress Updates

为重要子任务创建关联问题

bash
undefined
echo "$SUBTASKS" | jq -r '.tasks[] | select(.priority == "high")' | while read -r task; do TITLE=$(echo "$task" | jq -r '.title') BODY=$(echo "$task" | jq -r '.description')
gh issue create
--title "$TITLE"
--body "$BODY
父问题: #456"
--label "subtask" done
undefined

Get current issue state

自动化进度更新

CURRENT=$(gh issue view 456 --json body,labels)
bash
undefined

Get swarm progress

获取当前问题状态

PROGRESS=$(npx ruv-swarm github issue-progress 456)
CURRENT=$(gh issue view 456 --json body,labels)

Update checklist in issue body

获取Swarm进度

UPDATED_BODY=$(echo "$CURRENT" | jq -r '.body' |
npx ruv-swarm github update-checklist --progress "$PROGRESS")
PROGRESS=$(npx ruv-swarm github issue-progress 456)

Edit issue with updated body

更新问题内容中的检查清单

gh issue edit 456 --body "$UPDATED_BODY"
UPDATED_BODY=$(echo "$CURRENT" | jq -r '.body' |
npx ruv-swarm github update-checklist --progress "$PROGRESS")

Post progress summary as comment

编辑问题以更新内容

SUMMARY=$(echo "$PROGRESS" | jq -r ' "## 📊 Progress Update
Completion: (.completion)% ETA: (.eta)
gh issue edit 456 --body "$UPDATED_BODY"

Completed Tasks

发布进度摘要作为评论

(.completed | map("- ✅ " + .) | join("\n"))
SUMMARY=$(echo "$PROGRESS" | jq -r ' "## 📊 进度更新
完成度: (.completion)% 预计完成时间: (.eta)

In Progress

已完成任务

(.in_progress | map("- 🔄 " + .) | join("\n"))
(.completed | map("- ✅ " + .) | join("\n"))

Remaining

进行中任务

(.remaining | map("- ⏳ " + .) | join("\n"))
🤖 Automated update by swarm agent"')
gh issue comment 456 --body "$SUMMARY"
(.in_progress | map("- 🔄 " + .) | join("\n"))

Update labels based on progress

剩余任务

if [[ $(echo "$PROGRESS" | jq -r '.completion') -eq 100 ]]; then gh issue edit 456 --add-label "ready-for-review" --remove-label "in-progress" fi

<$details>

<details>
<summary><strong>Stale Issue Management<$strong><$summary>
(.remaining | map("- ⏳ " + .) | join("\n"))
🤖 由Swarm Agent自动更新"')
gh issue comment 456 --body "$SUMMARY"

Auto-Close Stale Issues with Swarm Analysis

根据进度更新标签

bash
undefined
if [[ $(echo "$PROGRESS" | jq -r '.completion') -eq 100 ]]; then gh issue edit 456 --add-label "ready-for-review" --remove-label "in-progress" fi

<$details>

<details>
<summary><strong>休眠问题管理<$strong><$summary>

Find stale issues

通过Swarm分析自动关闭休眠问题

STALE_DATE=$(date -d '30 days ago' --iso-8601) STALE_ISSUES=$(gh issue list --state open --json number,title,updatedAt,labels
--jq ".[] | select(.updatedAt < "$STALE_DATE")")
bash
undefined

Analyze each stale issue

查找休眠问题

echo "$STALE_ISSUES" | jq -r '.number' | while read -r num; do

Get full issue context

ISSUE=$(gh issue view $num --json title,body,comments,labels)

Analyze with swarm

ACTION=$(npx ruv-swarm github analyze-stale
--issue "$ISSUE"
--suggest-action)
case "$ACTION" in "close") gh issue comment $num --body "This issue has been inactive for 30 days and will be closed in 7 days if there's no further activity." gh issue edit $num --add-label "stale" ;; "keep") gh issue edit $num --remove-label "stale" 2>$dev$null || true ;; "needs-info") gh issue comment $num --body "This issue needs more information. Please provide additional context or it may be closed as stale." gh issue edit $num --add-label "needs-info" ;; esac done
STALE_DATE=$(date -d '30 days ago' --iso-8601) STALE_ISSUES=$(gh issue list --state open --json number,title,updatedAt,labels
--jq ".[] | select(.updatedAt < "$STALE_DATE")")

Close issues that have been stale for 37+ days

分析每个休眠问题

gh issue list --label stale --state open --json number,updatedAt
--jq ".[] | select(.updatedAt < "$(date -d '37 days ago' --iso-8601)") | .number" |
while read -r num; do gh issue close $num --comment "Closing due to inactivity. Feel free to reopen if this is still relevant." done

<$details>
echo "$STALE_ISSUES" | jq -r '.number' | while read -r num; do

获取完整问题上下文

ISSUE=$(gh issue view $num --json title,body,comments,labels)

使用Swarm分析

ACTION=$(npx ruv-swarm github analyze-stale
--issue "$ISSUE"
--suggest-action)
case "$ACTION" in "close") gh issue comment $num --body "此问题已30天未活跃，若无进一步操作将在7天后关闭。" gh issue edit $num --add-label "stale" ;; "keep") gh issue edit $num --remove-label "stale" 2>$dev$null || true ;; "needs-info") gh issue comment $num --body "此问题需要更多信息，请提供额外上下文，否则可能会被标记为休眠并关闭。" gh issue edit $num --add-label "needs-info" ;; esac done

2. Project Board Automation

关闭已休眠37天以上的问题

<details> <summary><strong>Board Initialization & Configuration<$strong><$summary>
gh issue list --label stale --state open --json number,updatedAt
--jq ".[] | select(.updatedAt < "$(date -d '37 days ago' --iso-8601)") | .number" |
while read -r num; do gh issue close $num --comment "因长期未活跃关闭，若仍相关可重新打开。" done

<$details>

Connect Swarm to GitHub Project

2. 项目看板自动化

bash
undefined
<details> <summary><strong>看板初始化与配置<$strong><$summary>

Get project details

将Swarm连接到GitHub项目

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

Initialize swarm with project

获取项目详情

npx ruv-swarm github board-init
--project-id "$PROJECT_ID"
--sync-mode "bidirectional"
--create-views "swarm-status,agent-workload,priority"
PROJECT_ID=$(gh project list --owner @me --format json |
jq -r '.projects[] | select(.title == "Development Board") | .id')

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
npx ruv-swarm github board-init
--project-id "$PROJECT_ID"
--sync-mode "bidirectional"
--create-views "swarm-status,agent-workload,priority"

Board Mapping Configuration

创建用于Swarm追踪的项目字段

yaml
undefined
gh project field-create $PROJECT_ID --owner @me
--name "Swarm Status"
--data-type "SINGLE_SELECT"
--single-select-options "pending,in_progress,completed"
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

<$details>

<details>
<summary><strong>Task Synchronization<$strong><$summary>
yaml
undefined

Real-time Board Sync

.github$board-sync.yml

bash
undefined
version: 1 project: name: "AI Development Board" number: 1
mapping:

将Swarm任务状态映射到看板列

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

将Agent类型映射到标签

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

将优先级映射到项目字段

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

自定义字段

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

<$details>

<details>
<summary><strong>任务同步<$strong><$summary>

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
bash
undefined

Enable real-time board updates

将Swarm任务与项目卡片同步

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-sync
--map-status '{ "todo": "To Do", "in_progress": "In Progress", "review": "Review", "done": "Done" }'
--auto-move-cards
--update-metadata

Convert Issues to Project Cards

启用实时看板更新

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

List issues with label

将问题转换为项目卡片

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

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
ISSUES=$(gh issue list --label "enhancement" --json number,title,body)

Process with swarm

将问题添加到项目

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

<$details>

<details>
<summary><strong>Smart Card Management<$strong><$summary>
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

Auto-Assignment

使用Swarm处理

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

<$details>

<details>
<summary><strong>智能卡片管理<$strong><$summary>

Automatically assign cards to agents

自动分配

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

Intelligent Card State Transitions

自动将卡片分配给Agent

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

Smart card movement based on rules

智能卡片状态转换

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
bash
undefined

Bulk Operations

基于规则的智能卡片移动

bash
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

Bulk card operations

批量操作

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

<$details>

<details>
<summary><strong>Custom Views & Dashboards<$strong><$summary>
bash
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"
    }
  ]
}
npx ruv-swarm github board-bulk
--filter "status:blocked"
--action "add-label:needs-attention"
--notify-assignees

<$details>

<details>
<summary><strong>自定义视图与仪表板<$strong><$summary>

Dashboard Configuration

视图配置

javascript
// Dashboard with performance widgets
{
  "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"
      }
    ]
  }
}
<$details>
javascript
// 自定义看板视图
{
  "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"
    }
  ]
}

3. Sprint Planning & Tracking

仪表板配置

<details> <summary><strong>Sprint Management<$strong><$summary>
javascript
// 带性能组件的仪表板
{
  "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"
      }
    ]
  }
}
<$details>

Initialize Sprint with Swarm Coordination

3. 迭代规划与追踪

bash
undefined
<details> <summary><strong>迭代管理<$strong><$summary>

Manage sprints with swarms

基于Swarm协作的迭代初始化

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

Track milestone progress

使用Swarm管理迭代

npx ruv-swarm github milestone-track
--milestone "v2.0 Release"
--update-board
--show-dependencies
--predict-completion
undefined
npx ruv-swarm github sprint-manage
--sprint "Sprint 23"
--auto-populate
--capacity-planning
--track-velocity

Agile Development Board Setup

追踪里程碑进度

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

Setup agile board

敏捷开发看板设置

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

Kanban Flow Board Setup

设置敏捷看板

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

Setup kanban board

看板流（Kanban）设置

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

<$details>

<details>
<summary><strong>Progress Tracking & Analytics<$strong><$summary>
bash
undefined

Board Analytics

设置Kanban看板

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

<$details>

<details>
<summary><strong>进度追踪与分析<$strong><$summary>

Fetch project data

看板分析

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

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)
PROJECT_DATA=$(gh project item-list $PROJECT_ID --owner @me --format json)

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

Performance Reports

使用Swarm生成分析报告

bash
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

Track and visualize progress

性能报告

npx ruv-swarm github board-progress
--show "burndown,velocity,cycle-time"
--time-period "sprint"
--export-metrics
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-progress
--show "burndown,velocity,cycle-time"
--time-period "sprint"
--export-metrics

KPI Tracking

生成报告

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

Track board performance

KPI追踪

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

Track team performance

追踪看板性能

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

<$details>

<details>
<summary><strong>Release Planning<$strong><$summary>
npx ruv-swarm github board-kpis
--metrics '[ "average-cycle-time", "throughput-per-sprint", "blocked-time-percentage", "first-time-pass-rate" ]'
--dashboard-url

Release Coordination

追踪团队性能

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

<$details>

<details>
<summary><strong>发布规划<$strong><$summary>

Plan releases using board data

发布协作

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

<$details>
bash
undefined

4. Advanced Coordination

利用看板数据规划发布

<details> <summary><strong>Multi-Board Synchronization<$strong><$summary>
npx ruv-swarm github release-plan-board
--analyze-velocity
--estimate-completion
--identify-risks
--optimize-scope

<$details>

Cross-Board Sync

4. 高级协作

bash
undefined
<details> <summary><strong>多看板同步<$strong><$summary>

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" }'
bash
undefined

Cross-organization sync

在多个看板间同步

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

<$details>

<details>
<summary><strong>Issue Dependencies & Epic Management<$strong><$summary>
npx ruv-swarm github multi-board-sync
--boards "Development,QA,Release"
--sync-rules '{ "Development->QA": "when:ready-for-test", "QA->Release": "when:tests-pass" }'

Dependency Resolution

跨组织同步

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

<$details>

<details>
<summary><strong>问题依赖与史诗（Epic）管理<$strong><$summary>

Handle issue dependencies

依赖解析

npx ruv-swarm github issue-deps 456
--resolve-order
--parallel-safe
--update-blocking
undefined
bash
undefined

Epic Coordination

处理问题依赖

bash
undefined
npx ruv-swarm github issue-deps 456
--resolve-order
--parallel-safe
--update-blocking
undefined

Coordinate epic-level swarms

史诗级协作

npx ruv-swarm github epic-swarm
--epic 123
--child-issues "456,457,458"
--orchestrate

<$details>

<details>
<summary><strong>Cross-Repository Coordination<$strong><$summary>
bash
undefined

Multi-Repo Issue Management

协调史诗级Swarm任务

bash
undefined
npx ruv-swarm github epic-swarm
--epic 123
--child-issues "456,457,458"
--orchestrate

<$details>

<details>
<summary><strong>跨仓库协作<$strong><$summary>

Handle issues across repositories

多仓库问题管理

npx ruv-swarm github cross-repo
--issue "org$repo#456"
--related "org$other-repo#123"
--coordinate

<$details>

<details>
<summary><strong>Team Collaboration<$strong><$summary>
bash
undefined

Work Distribution

处理跨仓库的问题

bash
undefined
npx ruv-swarm github cross-repo
--issue "org$repo#456"
--related "org$other-repo#123"
--coordinate

<$details>

<details>
<summary><strong>团队协作<$strong><$summary>

Distribute work among team

工作分配

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

Standup Automation

在团队中分配工作

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

Generate standup reports

站会自动化

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

Review Coordination

生成站会报告

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

Coordinate reviews via board

评审协作

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

<$details>

---
bash
undefined

Issue Templates

通过看板协调评审

Integration Issue Template

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

<$details>

---

🔄 Integration Task

问题模板

Overview

集成问题模板

[Brief description of integration requirements]
markdown
undefined

Objectives

🔄 集成任务

—

概述

  • Component A integration
  • Component B validation
  • Testing and verification
  • Documentation updates
[集成需求的简要描述]

Integration Areas

目标

Dependencies

—
  • Package.json updates
  • Version compatibility
  • Import statements
  • 组件A集成
  • 组件B验证
  • 测试与验证
  • 文档更新

Functionality

集成领域

—

依赖

  • Core feature integration
  • API compatibility
  • Performance validation
  • Package.json更新
  • 版本兼容性
  • 导入语句

Testing

功能

  • Unit tests
  • Integration tests
  • End-to-end validation
  • 核心功能集成
  • API兼容性
  • 性能验证

Swarm Coordination

测试

  • Coordinator: Overall progress tracking
  • Analyst: Technical validation
  • Tester: Quality assurance
  • Documenter: Documentation updates
  • 单元测试
  • 集成测试
  • 端到端验证

Progress Tracking

Swarm协作

Updates will be posted automatically by swarm agents during implementation.
🤖 Generated with Claude Code
undefined
  • 协调者: 整体进度追踪
  • 分析师: 技术验证
  • 测试者: 质量保证
  • 文档者: 文档更新

Bug Report Template

进度追踪

markdown
undefined
在实现过程中，Swarm Agent会自动发布进度更新。
🤖 由Claude Code生成
undefined

🐛 Bug Report

Bug报告模板

Problem Description

—
[Clear description of the issue]
markdown
undefined

Expected Behavior

🐛 Bug报告

—

问题描述

[What should happen]
[问题的清晰描述]

Actual Behavior

预期行为

[What actually happens]
[应该发生的情况]

Reproduction Steps

实际行为

  1. [Step 1]
  2. [Step 2]
  3. [Step 3]
[实际发生的情况]

Environment

复现步骤

  • Package: [package name and version]
  • Node.js: [version]
  • OS: [operating system]
  1. [步骤1]
  2. [步骤2]
  3. [步骤3]

Investigation Plan

环境

  • Root cause analysis
  • Fix implementation
  • Testing and validation
  • Regression testing
  • 包: [包名和版本]
  • Node.js: [版本]
  • 操作系统: [操作系统]

Swarm Assignment

调查计划

  • Debugger: Issue investigation
  • Coder: Fix implementation
  • Tester: Validation and testing
🤖 Generated with Claude Code
undefined
  • 根本原因分析
  • 修复实现
  • 测试与验证
  • 回归测试

Feature Request Template

Swarm分配

markdown
undefined
  • 调试者: 问题调查
  • 开发者: 修复实现
  • 测试者: 验证与测试
🤖 由Claude Code生成
undefined

✨ Feature Request

功能请求模板

Feature Description

—
[Clear description of the proposed feature]
markdown
undefined

Use Cases

✨ 功能请求

—

功能描述

  1. [Use case 1]
  2. [Use case 2]
  3. [Use case 3]
[拟议功能的清晰描述]

Acceptance Criteria

使用场景

  • Criterion 1
  • Criterion 2
  • Criterion 3
  1. [使用场景1]
  2. [使用场景2]
  3. [使用场景3]

Implementation Approach

验收标准

Design

—
  • Architecture design
  • API design
  • UI/UX mockups
  • 标准1
  • 标准2
  • 标准3

Development

实现方案

—

设计

  • Core implementation
  • Integration with existing features
  • Performance optimization
  • 架构设计
  • API设计
  • UI/UX原型

Testing

开发

  • Unit tests
  • Integration tests
  • User acceptance testing
  • 核心实现
  • 与现有功能集成
  • 性能优化

Swarm Coordination

测试

  • Architect: Design and planning
  • Coder: Implementation
  • Tester: Quality assurance
  • Documenter: Documentation
🤖 Generated with Claude Code
undefined
  • 单元测试
  • 集成测试
  • 用户验收测试

Swarm Task Template

Swarm协作

markdown
<!-- .github/ISSUE_TEMPLATE$swarm-task.yml -->
name: Swarm Task
description: Create a task for AI swarm processing
body:
  - type: dropdown
    id: topology
    attributes:
      label: Swarm Topology
      options:
        - mesh
        - hierarchical
        - ring
        - star
  - type: input
    id: agents
    attributes:
      label: Required Agents
      placeholder: "coder, tester, analyst"
  - type: textarea
    id: tasks
    attributes:
      label: Task Breakdown
      placeholder: |
        1. Task one description
        2. Task two description
  • 架构师: 设计与规划
  • 开发者: 实现
  • 测试者: 质量保证
  • 文档者: 文档编写
🤖 由Claude Code生成
undefined

Workflow Integration

Swarm任务模板

GitHub Actions for Issue Management

—
yaml
undefined
markdown
<!-- .github/ISSUE_TEMPLATE$swarm-task.yml -->
name: Swarm Task
description: 创建用于AI Swarm处理的任务
body:
  - type: dropdown
    id: topology
    attributes:
      label: Swarm拓扑
      options:
        - mesh
        - hierarchical
        - ring
        - star
  - type: input
    id: agents
    attributes:
      label: 所需Agent
      placeholder: "coder, tester, analyst"
  - type: textarea
    id: tasks
    attributes:
      label: 任务分解
      placeholder: |
        1. 任务一描述
        2. 任务二描述

.github$workflows$issue-swarm.yml

工作流集成

—

用于问题管理的GitHub Actions

name: Issue Swarm Handler on: issues: types: [opened, labeled, commented]
jobs: swarm-process: runs-on: ubuntu-latest steps: - name: Process Issue uses: ruvnet$swarm-action@v1 with: command: | if [[ "${{ github.event.label.name }}" == "swarm-ready" ]]; then npx ruv-swarm github issue-init ${{ github.event.issue.number }} fi
undefined
yaml
undefined

Board Integration Workflow

.github$workflows$issue-swarm.yml

bash
undefined
name: Issue Swarm Handler on: issues: types: [opened, labeled, commented]
jobs: swarm-process: runs-on: ubuntu-latest steps: - name: 处理问题 uses: ruvnet$swarm-action@v1 with: command: | if [[ "${{ github.event.label.name }}" == "swarm-ready" ]]; then npx ruv-swarm github issue-init ${{ github.event.issue.number }} fi
undefined

Sync with project board

看板集成工作流

npx ruv-swarm github issue-board-sync
--project "Development"
--column-mapping '{ "To Do": "pending", "In Progress": "active", "Done": "completed" }'

---
bash
undefined

Specialized Issue Strategies

与项目看板同步

Bug Investigation Swarm

—
bash
undefined
npx ruv-swarm github issue-board-sync
--project "Development"
--column-mapping '{ "To Do": "pending", "In Progress": "active", "Done": "completed" }'

---

Specialized bug handling

专项问题策略

—

Bug调查Swarm

npx ruv-swarm github bug-swarm 456
--reproduce
--isolate
--fix
--test
undefined
bash
undefined

Feature Implementation Swarm

专项Bug处理

bash
undefined
npx ruv-swarm github bug-swarm 456
--reproduce
--isolate
--fix
--test
undefined

Feature implementation swarm

功能实现Swarm

npx ruv-swarm github feature-swarm 456
--design
--implement
--document
--demo
undefined
bash
undefined

Technical Debt Refactoring

功能实现Swarm

bash
undefined
npx ruv-swarm github feature-swarm 456
--design
--implement
--document
--demo
undefined

Refactoring swarm

技术债务重构

npx ruv-swarm github debt-swarm 456
--analyze-impact
--plan-migration
--execute
--validate

---
bash
undefined

Best Practices

重构Swarm

1. Swarm-Coordinated Issue Management

—
  • Always initialize swarm for complex issues
  • Assign specialized agents based on issue type
  • Use memory for progress coordination
  • Regular automated progress updates
npx ruv-swarm github debt-swarm 456
--analyze-impact
--plan-migration
--execute
--validate

---

2. Board Organization

最佳实践

—

1. Swarm协作式问题管理

  • Clear column definitions with consistent naming
  • Systematic labeling strategy across repositories
  • Regular board grooming and maintenance
  • Well-defined automation rules
  • 对于复杂问题，始终初始化Swarm
  • 根据问题类型分配专业Agent
  • 使用内存进行进度协调
  • 定期自动更新进度

3. Data Integrity

2. 看板组织

  • Bidirectional sync validation
  • Conflict resolution strategies
  • Comprehensive audit trails
  • Regular backups of project data
  • 清晰的列定义与一致的命名
  • 跨仓库的系统化标签策略
  • 定期的看板梳理与维护
  • 定义明确的自动化规则

4. Team Adoption

3. 数据完整性

  • Comprehensive training materials
  • Clear, documented workflows
  • Regular team reviews and retrospectives
  • Active feedback loops for improvement
  • 双向同步验证
  • 冲突解决策略
  • 全面的审计追踪
  • 定期备份项目数据

5. Smart Labeling and Organization

4. 团队采用

  • Consistent labeling strategy across repositories
  • Priority-based issue sorting and assignment
  • Milestone integration for project coordination
  • Agent-type to label mapping
  • 全面的培训材料
  • 清晰、文档化的工作流
  • 定期的团队评审与回顾
  • 积极的反馈改进循环

6. Automated Progress Tracking

5. 智能标签与组织

  • Regular automated updates with swarm coordination
  • Progress metrics and completion tracking
  • Cross-issue dependency management
  • Real-time status synchronization
  • 跨仓库的一致标签策略
  • 基于优先级的问题排序与分配
  • 用于项目协调的里程碑集成
  • Agent类型到标签的映射

Troubleshooting

6. 自动化进度追踪

Sync Issues

—
bash
undefined
  • 基于Swarm协作的定期自动更新
  • 进度指标与完成度追踪
  • 跨问题依赖管理
  • 实时状态同步

Diagnose sync problems

故障排除

—

同步问题

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

Performance Optimization

诊断同步问题

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

Optimize board performance

性能优化

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

Data Recovery

优化看板性能

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

Recover board data

数据恢复

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

---
bash
undefined

Metrics & Analytics

恢复看板数据

Performance Metrics

—
Automatic tracking of:
  • Issue creation and resolution times
  • Agent productivity metrics
  • Project milestone progress
  • Cross-repository coordination efficiency
  • Sprint velocity and burndown
  • Cycle time and throughput
  • Work-in-progress limits
npx ruv-swarm github board-recover
--backup-id "2024-01-15"
--restore-cards
--preserve-current
--merge-conflicts

---

Reporting Features

指标与分析

—

性能指标

  • Weekly progress summaries
  • Agent performance analytics
  • Project health metrics
  • Integration success rates
  • Team collaboration metrics
  • Quality and defect tracking
自动追踪：
  • 问题创建与解决时间
  • Agent生产力指标
  • 项目里程碑进度
  • 跨仓库协作效率
  • 迭代速度与燃尽图
  • 周期时间与吞吐量
  • 在制品限制

Issue Resolution Time

报告功能

bash
undefined
  • 每周进度摘要
  • Agent性能分析
  • 项目健康指标
  • 集成成功率
  • 团队协作指标
  • 质量与缺陷追踪

Analyze swarm performance

问题解决时间

npx ruv-swarm github issue-metrics
--issue 456
--metrics "time-to-close,agent-efficiency,subtask-completion"
undefined
bash
undefined

Swarm Effectiveness

分析Swarm性能

bash
undefined
npx ruv-swarm github issue-metrics
--issue 456
--metrics "time-to-close,agent-efficiency,subtask-completion"
undefined

Generate effectiveness report

Swarm有效性

npx ruv-swarm github effectiveness
--issues "closed:>2024-01-01"
--compare "with-swarm,without-swarm"

---
bash
undefined

Security & Permissions

生成有效性报告

  1. Command Authorization: Validate user permissions before executing commands
  2. Rate Limiting: Prevent spam and abuse of issue commands
  3. Audit Logging: Track all swarm operations on issues and boards
  4. Data Privacy: Respect private repository settings
  5. Access Control: Proper GitHub permissions for board operations
  6. Webhook Security: Secure webhook endpoints for real-time updates
npx ruv-swarm github effectiveness
--issues "closed:>2024-01-01"
--compare "with-swarm,without-swarm"

---

Integration with Other Skills

安全与权限

Seamless Integration With:

—
  • github-pr-workflow
    - Link issues to pull requests automatically
  • github-release-management
    - Coordinate release issues and milestones
  • sparc-orchestrator
    - Complex project coordination workflows
  • sparc-tester
    - Automated testing workflows for issues
  1. 命令授权: 在执行命令前验证用户权限
  2. 速率限制: 防止问题命令的滥用与垃圾信息
  3. 审计日志: 追踪所有针对问题和看板的Swarm操作
  4. 数据隐私: 尊重私有仓库设置
  5. 访问控制: 为看板操作配置正确的GitHub权限
  6. Webhook安全: 为实时更新配置安全的Webhook端点

Complete Workflow Example

与其他工具的集成

Full-Stack Feature Development

无缝集成：

bash
undefined
  • github-pr-workflow
    - 自动将问题与拉取请求关联
  • github-release-management
    - 协调发布问题与里程碑
  • sparc-orchestrator
    - 复杂项目协调工作流
  • sparc-tester
    - 针对问题的自动化测试工作流

1. Create feature issue with swarm coordination

完整工作流示例

—

全栈功能开发

gh issue create
--title "Feature: Real-time Collaboration"
--body "$(cat <<EOF
bash
undefined

Feature: Real-time Collaboration

1. 创建带Swarm协作的功能问题

Overview

—
Implement real-time collaboration features using WebSockets.
gh issue create
--title "Feature: Real-time Collaboration"
--body "$(cat <<EOF

Objectives

Feature: Real-time Collaboration

—

概述

  • WebSocket server setup
  • Client-side integration
  • Presence tracking
  • Conflict resolution
  • Testing and documentation
使用WebSocket实现实时协作功能。

Swarm Coordination

目标

This feature will use mesh topology for parallel development. EOF )"
--label "enhancement,swarm-ready,high-priority"
  • WebSocket服务器设置
  • 客户端集成
  • 在线状态追踪
  • 冲突解决
  • 测试与文档

2. Initialize swarm and decompose tasks

Swarm协作

ISSUE_NUM=$(gh issue list --label "swarm-ready" --limit 1 --json number --jq '.[0].number') npx ruv-swarm github issue-init $ISSUE_NUM
--topology mesh
--auto-decompose
--assign-agents "architect,coder,tester"
此功能将使用mesh拓扑进行并行开发。 EOF )"
--label "enhancement,swarm-ready,high-priority"

3. Add to project board

2. 初始化Swarm并分解任务

PROJECT_ID=$(gh project list --owner @me --format json | jq -r '.projects[0].id') gh project item-add $PROJECT_ID --owner @me
--url "https:/$github.com/$GITHUB_REPOSITORY$issues/$ISSUE_NUM"
ISSUE_NUM=$(gh issue list --label "swarm-ready" --limit 1 --json number --jq '.[0].number') npx ruv-swarm github issue-init $ISSUE_NUM
--topology mesh
--auto-decompose
--assign-agents "architect,coder,tester"

4. Set up automated tracking

3. 添加到项目看板

npx ruv-swarm github board-sync
--auto-move-cards
--update-metadata
PROJECT_ID=$(gh project list --owner @me --format json | jq -r '.projects[0].id') gh project item-add $PROJECT_ID --owner @me
--url "https:/$github.com/$GITHUB_REPOSITORY$issues/$ISSUE_NUM"

5. Monitor progress

4. 设置自动化追踪

npx ruv-swarm github issue-progress $ISSUE_NUM
--auto-update-comments
--notify-on-completion

---
npx ruv-swarm github board-sync
--auto-move-cards
--update-metadata

Quick Reference Commands

5. 监控进度

bash
undefined
npx ruv-swarm github issue-progress $ISSUE_NUM
--auto-update-comments
--notify-on-completion

---

Issue Management

快速参考命令

gh issue create --title "..." --body "..." --label "..." npx ruv-swarm github issue-init <number> npx ruv-swarm github issue-decompose <number> npx ruv-swarm github triage --unlabeled
bash
undefined

Project Boards

问题管理

npx ruv-swarm github board-init --project-id <id> npx ruv-swarm github board-sync npx ruv-swarm github board-analytics
gh issue create --title "..." --body "..." --label "..." npx ruv-swarm github issue-init <number> npx ruv-swarm github issue-decompose <number> npx ruv-swarm github triage --unlabeled

Sprint Management

项目看板

npx ruv-swarm github sprint-manage --sprint "Sprint X" npx ruv-swarm github milestone-track --milestone "vX.X"
npx ruv-swarm github board-init --project-id <id> npx ruv-swarm github board-sync npx ruv-swarm github board-analytics

Analytics

迭代管理

npx ruv-swarm github issue-metrics --issue <number> npx ruv-swarm github board-kpis

---
npx ruv-swarm github sprint-manage --sprint "Sprint X" npx ruv-swarm github milestone-track --milestone "vX.X"

Additional Resources

分析

Last Updated: 2025-10-19 Version: 2.0.0 Maintainer: Claude Code
npx ruv-swarm github issue-metrics --issue <number> npx ruv-swarm github board-kpis

---
—

额外资源

—
最后更新: 2025-10-19 版本: 2.0.0 维护者: Claude Code