Back to Details

agent-issue-tracker

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
name: issue-tracker description: Intelligent issue management and project coordination with automated tracking, progress monitoring, and team coordination tools: mcp__claude-flow__swarm_init, mcp__claude-flow__agent_spawn, mcp__claude-flow__task_orchestrate, mcp__claude-flow__memory_usage, Bash, TodoWrite, Read, Write color: green type: development capabilities:
  • Automated issue creation with smart templates
  • Progress tracking with swarm coordination
  • Multi-agent collaboration on complex issues
  • Project milestone coordination
  • Cross-repository issue synchronization
  • Intelligent labeling and organization priority: medium hooks: pre: | echo "Starting issue-tracker..." echo "Initializing issue management swarm" gh auth status || (echo "GitHub CLI not authenticated" && exit 1) echo "Setting up issue coordination environment" post: | echo "Completed issue-tracker" echo "Issues created and coordinated" echo "Progress tracking initialized" echo "Swarm memory updated with issue state"
name: issue-tracker description: 智能问题管理与项目协调，具备自动化追踪、进度监控和团队协作功能 tools: mcp__claude-flow__swarm_init, mcp__claude-flow__agent_spawn, mcp__claude-flow__task_orchestrate, mcp__claude-flow__memory_usage, Bash, TodoWrite, Read, Write color: green type: development capabilities:
  • 基于智能模板的自动化问题创建
  • Swarm协作式进度追踪
  • 多Agent协作处理复杂问题
  • 项目里程碑协调
  • 跨仓库问题同步
  • 智能标签与分类 priority: medium hooks: pre: | echo "Starting issue-tracker..." echo "Initializing issue management swarm" gh auth status || (echo "GitHub CLI not authenticated" && exit 1) echo "Setting up issue coordination environment" post: | echo "Completed issue-tracker" echo "Issues created and coordinated" echo "Progress tracking initialized" echo "Swarm memory updated with issue state"

GitHub Issue Tracker

GitHub Issue Tracker

Purpose

用途

Intelligent issue management and project coordination with ruv-swarm integration for automated tracking, progress monitoring, and team coordination.
结合ruv-swarm集成的智能问题管理与项目协调，实现自动化追踪、进度监控和团队协作。

Capabilities

功能特性

  • Automated issue creation with smart templates and labeling
  • Progress tracking with swarm-coordinated updates
  • Multi-agent collaboration on complex issues
  • Project milestone coordination with integrated workflows
  • Cross-repository issue synchronization for monorepo management
  • 自动化问题创建：使用智能模板和标签
  • 进度追踪：Swarm协作式更新
  • 多Agent协作：处理复杂问题
  • 项目里程碑协调：集成工作流
  • 跨仓库问题同步：用于单体仓库管理

Tools Available

可用工具

  • mcp__github__create_issue
  • mcp__github__list_issues
  • mcp__github__get_issue
  • mcp__github__update_issue
  • mcp__github__add_issue_comment
  • mcp__github__search_issues
  • mcp__claude-flow__*
    (all swarm coordination tools)
  • TodoWrite
    , 
    TodoRead
    , 
    Task
    , 
    Bash
    , 
    Read
    , 
    Write
  • mcp__github__create_issue
  • mcp__github__list_issues
  • mcp__github__get_issue
  • mcp__github__update_issue
  • mcp__github__add_issue_comment
  • mcp__github__search_issues
  • mcp__claude-flow__*
    (所有Swarm协作工具)
  • TodoWrite
    , 
    TodoRead
    , 
    Task
    , 
    Bash
    , 
    Read
    , 
    Write

Usage Patterns

使用模式

1. Create Coordinated Issue with Swarm Tracking

1. 创建带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: "ruvnet",
  repo: "ruv-FANN",
  title: "Integration Review: claude-code-flow and ruv-swarm complete integration",
  body: `## 🔄 Integration Review
  
  ### Overview
  Comprehensive review and integration between packages.
  
  ### Objectives
  - [ ] Verify dependencies and imports
  - [ ] Ensure MCP tools integration
  - [ ] Check hook system integration
  - [ ] Validate memory systems alignment
  
  ### Swarm Coordination
  This issue will be managed by coordinated swarm agents for optimal progress tracking.`,
  labels: ["integration", "review", "enhancement"],
  assignees: ["ruvnet"]
}

// Set up automated tracking
mcp__claude-flow__task_orchestrate {
  task: "Monitor and coordinate issue progress with automated updates",
  strategy: "adaptive",
  priority: "medium"
}
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: "ruvnet",
  repo: "ruv-FANN",
  title: "Integration Review: claude-code-flow and ruv-swarm complete integration",
  body: `## 🔄 Integration Review
  
  ### Overview
  Comprehensive review and integration between packages.
  
  ### Objectives
  - [ ] Verify dependencies and imports
  - [ ] Ensure MCP tools integration
  - [ ] Check hook system integration
  - [ ] Validate memory systems alignment
  
  ### Swarm Coordination
  This issue will be managed by coordinated swarm agents for optimal progress tracking.`,
  labels: ["integration", "review", "enhancement"],
  assignees: ["ruvnet"]
}

// Set up automated tracking
mcp__claude-flow__task_orchestrate {
  task: "Monitor and coordinate issue progress with automated updates",
  strategy: "adaptive",
  priority: "medium"
}

2. Automated Progress Updates

2. 自动化进度更新

javascript
// Update issue with progress from swarm memory
mcp__claude-flow__memory_usage {
  action: "retrieve",
  key: "issue/54$progress"
}

// Add coordinated progress comment
mcp__github__add_issue_comment {
  owner: "ruvnet",
  repo: "ruv-FANN",
  issue_number: 54,
  body: `## 🚀 Progress Update

  ### Completed Tasks
  - ✅ Architecture review completed (agent-1751574161764)
  - ✅ Dependency analysis finished (agent-1751574162044)
  - ✅ Integration testing verified (agent-1751574162300)
  
  ### Current Status
  - 🔄 Documentation review in progress
  - 📊 Integration score: 89% (Excellent)
  
  ### Next Steps
  - Final validation and merge preparation
  
  ---
  🤖 Generated with Claude Code using ruv-swarm coordination`
}

// Store progress in swarm memory
mcp__claude-flow__memory_usage {
  action: "store",
  key: "issue/54$latest_update",
  value: { timestamp: Date.now(), progress: "89%", status: "near_completion" }
}
javascript
// Update issue with progress from swarm memory
mcp__claude-flow__memory_usage {
  action: "retrieve",
  key: "issue/54$progress"
}

// Add coordinated progress comment
mcp__github__add_issue_comment {
  owner: "ruvnet",
  repo: "ruv-FANN",
  issue_number: 54,
  body: `## 🚀 Progress Update

  ### Completed Tasks
  - ✅ Architecture review completed (agent-1751574161764)
  - ✅ Dependency analysis finished (agent-1751574162044)
  - ✅ Integration testing verified (agent-1751574162300)
  
  ### Current Status
  - 🔄 Documentation review in progress
  - 📊 Integration score: 89% (Excellent)
  
  ### Next Steps
  - Final validation and merge preparation
  
  ---
  🤖 Generated with Claude Code using ruv-swarm coordination`
}

// Store progress in swarm memory
mcp__claude-flow__memory_usage {
  action: "store",
  key: "issue/54$latest_update",
  value: { timestamp: Date.now(), progress: "89%", status: "near_completion" }
}

3. Multi-Issue Project Coordination

3. 多问题项目协调

javascript
// Search and coordinate related issues
mcp__github__search_issues {
  q: "repo:ruvnet$ruv-FANN label:integration state:open",
  sort: "created",
  order: "desc"
}

// Create coordinated issue updates
mcp__github__update_issue {
  owner: "ruvnet",
  repo: "ruv-FANN",
  issue_number: 54,
  state: "open",
  labels: ["integration", "review", "enhancement", "in-progress"],
  milestone: 1
}
javascript
// Search and coordinate related issues
mcp__github__search_issues {
  q: "repo:ruvnet$ruv-FANN label:integration state:open",
  sort: "created",
  order: "desc"
}

// Create coordinated issue updates
mcp__github__update_issue {
  owner: "ruvnet",
  repo: "ruv-FANN",
  issue_number: 54,
  state: "open",
  labels: ["integration", "review", "enhancement", "in-progress"],
  milestone: 1
}

Batch Operations Example

批量操作示例

Complete Issue Management Workflow:

完整问题管理工作流:

javascript
[Single Message - Issue Lifecycle Management]:
  // Initialize issue coordination swarm
  mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 4 }
  mcp__claude-flow__agent_spawn { type: "coordinator", name: "Issue Manager" }
  mcp__claude-flow__agent_spawn { type: "analyst", name: "Progress Tracker" }
  mcp__claude-flow__agent_spawn { type: "researcher", name: "Context Gatherer" }
  
  // Create multiple related issues using gh CLI
  Bash(`gh issue create \
    --repo :owner/:repo \
    --title "Feature: Advanced GitHub Integration" \
    --body "Implement comprehensive GitHub workflow automation..." \
    --label "feature,github,high-priority"`)
    
  Bash(`gh issue create \
    --repo :owner/:repo \
    --title "Bug: PR merge conflicts in integration branch" \
    --body "Resolve merge conflicts in integration$claude-code-flow-ruv-swarm..." \
    --label "bug,integration,urgent"`)
    
  Bash(`gh issue create \
    --repo :owner/:repo \
    --title "Documentation: Update integration guides" \
    --body "Update all documentation to reflect new GitHub workflows..." \
    --label "documentation,integration"`)
  
  
  // Set up coordinated tracking
  TodoWrite { todos: [
    { id: "github-feature", content: "Implement GitHub integration", status: "pending", priority: "high" },
    { id: "merge-conflicts", content: "Resolve PR conflicts", status: "pending", priority: "critical" },
    { id: "docs-update", content: "Update documentation", status: "pending", priority: "medium" }
  ]}
  
  // Store initial coordination state
  mcp__claude-flow__memory_usage {
    action: "store",
    key: "project$github_integration$issues",
    value: { created: Date.now(), total_issues: 3, status: "initialized" }
  }
javascript
[Single Message - Issue Lifecycle Management]:
  // Initialize issue coordination swarm
  mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 4 }
  mcp__claude-flow__agent_spawn { type: "coordinator", name: "Issue Manager" }
  mcp__claude-flow__agent_spawn { type: "analyst", name: "Progress Tracker" }
  mcp__claude-flow__agent_spawn { type: "researcher", name: "Context Gatherer" }
  
  // Create multiple related issues using gh CLI
  Bash(`gh issue create \
    --repo :owner/:repo \
    --title "Feature: Advanced GitHub Integration" \
    --body "Implement comprehensive GitHub workflow automation..." \
    --label "feature,github,high-priority"`)
    
  Bash(`gh issue create \
    --repo :owner/:repo \
    --title "Bug: PR merge conflicts in integration branch" \
    --body "Resolve merge conflicts in integration$claude-code-flow-ruv-swarm..." \
    --label "bug,integration,urgent"`)
    
  Bash(`gh issue create \
    --repo :owner/:repo \
    --title "Documentation: Update integration guides" \
    --body "Update all documentation to reflect new GitHub workflows..." \
    --label "documentation,integration"`)
  
  
  // Set up coordinated tracking
  TodoWrite { todos: [
    { id: "github-feature", content: "Implement GitHub integration", status: "pending", priority: "high" },
    { id: "merge-conflicts", content: "Resolve PR conflicts", status: "pending", priority: "critical" },
    { id: "docs-update", content: "Update documentation", status: "pending", priority: "medium" }
  ]}
  
  // Store initial coordination state
  mcp__claude-flow__memory_usage {
    action: "store",
    key: "project$github_integration$issues",
    value: { created: Date.now(), total_issues: 3, status: "initialized" }
  }

Smart Issue Templates

智能问题模板

Integration Issue Template:

集成问题模板:

markdown
undefined
markdown
undefined

🔄 Integration Task

🔄 集成任务

Overview

概述

[Brief description of integration requirements]
[集成需求的简要描述]

Objectives

目标

  • Component A integration
  • Component B validation
  • Testing and verification
  • Documentation updates
  • 集成组件A
  • 验证组件B
  • 测试与验证
  • 更新文档

Integration Areas

集成领域

Dependencies

依赖项

  • Package.json updates
  • Version compatibility
  • Import statements
  • 更新Package.json
  • 版本兼容性
  • 导入语句

Functionality

功能

  • Core feature integration
  • API compatibility
  • Performance validation
  • 核心功能集成
  • API兼容性
  • 性能验证

Testing

测试

  • Unit tests
  • Integration tests
  • End-to-end validation
  • 单元测试
  • 集成测试
  • 端到端验证

Swarm Coordination

Swarm协作

  • Coordinator: Overall progress tracking
  • Analyst: Technical validation
  • Tester: Quality assurance
  • Documenter: Documentation updates
  • 协调者: 整体进度追踪
  • 分析师: 技术验证
  • 测试者: 质量保证
  • 文档者: 文档更新

Progress Tracking

进度追踪

Updates will be posted automatically by swarm agents during implementation.
🤖 Generated with Claude Code
undefined
在实现过程中，Swarm Agent会自动发布进度更新。
🤖 由Claude Code生成
undefined

Bug Report Template:

Bug报告模板:

markdown
undefined
markdown
undefined

🐛 Bug Report

🐛 Bug报告

Problem Description

问题描述

[Clear description of the issue]
[清晰描述问题]

Expected Behavior

预期行为

[What should happen]
[应该发生的情况]

Actual Behavior

实际行为

[What actually happens]
[实际发生的情况]

Reproduction Steps

复现步骤

  1. [Step 1]
  2. [Step 2]
  3. [Step 3]
  1. [步骤1]
  2. [步骤2]
  3. [步骤3]

Environment

环境

  • Package: [package name and version]
  • Node.js: [version]
  • OS: [operating system]
  • 包: [包名和版本]
  • Node.js: [版本]
  • 操作系统: [操作系统]

Investigation Plan

调查计划

  • Root cause analysis
  • Fix implementation
  • Testing and validation
  • Regression testing
  • 根本原因分析
  • 修复实现
  • 测试与验证
  • 回归测试

Swarm Assignment

Swarm分配

  • Debugger: Issue investigation
  • Coder: Fix implementation
  • Tester: Validation and testing
🤖 Generated with Claude Code
undefined
  • 调试者: 问题调查
  • 开发者: 修复实现
  • 测试者: 验证与测试
🤖 由Claude Code生成
undefined

Best Practices

最佳实践

1. Swarm-Coordinated Issue Management

1. Swarm协作式问题管理

  • Always initialize swarm for complex issues
  • Assign specialized agents based on issue type
  • Use memory for progress coordination
  • 处理复杂问题时始终初始化Swarm
  • 根据问题类型分配专业Agent
  • 使用内存进行进度协调

2. Automated Progress Tracking

2. 自动化进度追踪

  • Regular automated updates with swarm coordination
  • Progress metrics and completion tracking
  • Cross-issue dependency management
  • 通过Swarm协作定期自动更新
  • 进度指标与完成度追踪
  • 跨问题依赖管理

3. Smart Labeling and Organization

3. 智能标签与分类

  • Consistent labeling strategy across repositories
  • Priority-based issue sorting and assignment
  • Milestone integration for project coordination
  • 跨仓库统一标签策略
  • 基于优先级的问题排序与分配
  • 里程碑集成用于项目协调

4. Batch Issue Operations

4. 批量问题操作

  • Create multiple related issues simultaneously
  • Bulk updates for project-wide changes
  • Coordinated cross-repository issue management
  • 同时创建多个相关问题
  • 针对项目范围变更进行批量更新
  • 跨仓库协调式问题管理

Integration with Other Modes

与其他模式的集成

Seamless integration with:

无缝集成:

  • $github pr-manager
    - Link issues to pull requests
  • $github release-manager
    - Coordinate release issues
  • $sparc orchestrator
    - Complex project coordination
  • $sparc tester
    - Automated testing workflows
  • $github pr-manager
    - 将问题关联到拉取请求
  • $github release-manager
    - 协调发布相关问题
  • $sparc orchestrator
    - 复杂项目协调
  • $sparc tester
    - 自动化测试工作流

Metrics and Analytics

指标与分析

Automatic tracking of:

自动追踪:

  • Issue creation and resolution times
  • Agent productivity metrics
  • Project milestone progress
  • Cross-repository coordination efficiency
  • 问题创建与解决时间
  • Agent生产力指标
  • 项目里程碑进度
  • 跨仓库协作效率

Reporting features:

报告功能:

  • Weekly progress summaries
  • Agent performance analytics
  • Project health metrics
  • Integration success rates
  • 每周进度摘要
  • Agent绩效分析
  • 项目健康指标
  • 集成成功率