智能问题跟踪_agent-issue-tracker

智能问题跟踪_agent-issue-tracker

以下为本文档的中文说明

Agent Issue Tracker 是 ruvnet 生态中的一个智能问题跟踪技能,它将 GitHub Issue 管理与 ruv-swarm 多智能体协调系统深度集成。核心能力包括:自动创建 Issue 并附带智能模板和标签、通过群组协调更新实现进度追踪、多 Agent 在复杂 Issue 上的协作、项目里程碑的集成化工作流协调、以及跨仓库的 Issue 同步(适用于单体仓库管理)。该技能集成了丰富的工具集:GitHub MCP 工具(创建、列出、获取、更新 Issue,添加评论,搜索 Issue)和 claude-flow 群组协调工具(TodoWrite、Task 等)。使用场景涵盖软件项目管理中的各类需求——从 Bug 报告和功能请求的自动分类,到 Sprint 规划和进度跟踪,再到多团队协作的复杂项目管理。该技能的核心价值在于将问题管理从被动的人工操作转变为 AI 主动驱动的自动化流程,Agent 能够自动识别问题类型、分配责任人、跟踪解决进度,并在必要时协调多个 Agent 协同工作。它还支持跨仓库的统一视图管理,特别适合采用单体仓库(Monorepo)架构的团队。通过智能化的自动化流程,该技能显著减少了人工跟踪问题的时间投入,让团队能够更专注于实际的开发工作。


GitHub Issue Tracker

Purpose

Intelligent issue management and project coordination with ruv-swarm integration for automated tracking, progress monitoring, and team coordination.

Capabilities

  • Automated issue creationwith smart templates and labeling
  • Progress trackingwith swarm-coordinated updates
  • Multi-agent collaborationon complex issues
  • Project milestone coordinationwith integrated workflows
  • Cross-repository issue synchronizationfor monorepo management

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

Usage Patterns

1. Create Coordinated Issue with Swarm Tracking

// Initialize issue management swarmmcp__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 issuemcp__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 trackingmcp__claude-flow__task_orchestrate{task:"Monitor and coordinate issue progress with automated updates",strategy:"adaptive",priority:"medium"}

2. Automated Progress Updates

// Update issue with progress from swarm memorymcp__claude-flow__memory_usage{action:"retrieve",key:"issue/54$progress"}// Add coordinated progress commentmcp__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 memorymcp__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

// Search and coordinate related issuesmcp__github__search_issues{q:"repo:ruvnet$ruv-FANN label:integration state:open",sort:"created",order:"desc"}// Create coordinated issue updatesmcp__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:

[Single Message-Issue Lifecycle Management]:// Initialize issue coordination swarmmcp__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 CLIBash(`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 trackingTodoWrite{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 statemcp__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:

## 🔄 Integration Task ### Overview [Brief description of integration requirements] ### Objectives - [ ] Component A integration - [ ] Component B validation - [ ] Testing and verification - [ ] Documentation updates ### Integration Areas #### Dependencies - [ ] Package.json updates - [ ] Version compatibility - [ ] Import statements #### Functionality - [ ] Core feature integration - [ ] API compatibility - [ ] Performance validation #### Testing - [ ] Unit tests - [ ] Integration tests - [ ] End-to-end validation ### Swarm Coordination - **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

Bug Report Template:

## 🐛 Bug Report ### 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] ### Environment - Package: [package name and version] - Node.js: [version] - OS: [operating system] ### Investigation Plan - [ ] Root cause analysis - [ ] Fix implementation - [ ] Testing and validation - [ ] Regression testing ### Swarm Assignment - **Debugger**: Issue investigation - **Coder**: Fix implementation - **Tester**: Validation and testing --- 🤖 Generated with Claude Code

Best Practices

1.Swarm-Coordinated Issue Management

  • Always initialize swarm for complex issues
  • Assign specialized agents based on issue type
  • Use memory for p
    rogress coordination

2.Automated Progress Tracking

  • Regular automated updates with swarm coordination
  • Progress metrics and completion tracking
  • Cross-issue dependency management

3.Smart Labeling and Organization

  • Consistent labeling strategy across repositories
  • Priority-based issue sorting and assignment
  • Milestone integration for project coordination

4.Batch Issue Operations

  • 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

Metrics and Analytics

Automatic tracking of:

  • Issue creation and resolution times
  • Agent productivity metrics
  • Project milestone progress
  • Cross-repository coordination efficiency

Reporting features:

  • Weekly progress summaries
  • Agent performance analytics
  • Project health metrics
  • Integration success rates3d:[“","","","L40”,null,{“content”:“$41”,“frontMatter”:{“name”:“agent-issue-tracker”,“description”:“Agent skill for issue-tracker - invoke with $agent-issue-tracker”}}]

3e:[“KaTeX parse error: Expected '}', got 'EOF' at end of input: …,"children":[["”,“div”,null,{“className”:“flex items-center justify-between border-b border-border bg-muted/30 px-4 py-2.5”,“children”:[[“KaTeX parse error: Expected '}', got 'EOF' at end of input: …","children":["”,“span”,null,{“className”:“truncate text-xs font-medium text-muted-foreground”,“children”:“同仓库更多 Skills”}]}],[“KaTeX parse error: Expected 'EOF', got '}' at position 88: …ldren":"同仓库"}]]}̲],["”,“div”,null,{“className”:“p-4 sm:p-5”,“children”:[[“","h2",null,"id":"related−skills−heading","className":"text−2xlfont−semiboldtracking−normaltext−foreground","children":"同仓库更多Skills"],["","h2",null,{"id":"related-skills-heading","className":"text-2xl font-semibold tracking-normal text-foreground","children":"同仓库更多 Skills"}],["","h2",null,"id":"relatedskillsheading","className":"text2xlfontsemiboldtrackingnormaltextforeground","children":"同仓库更多Skills"],["”,“div”,null,{“className”:“mt-4 grid gap-3 sm:grid-cols-2”,“children”:[“L42","L42","L42","L43”,“L44","L44","L44","L45”,“L46","L46","L46","L47”]}]]}]]}]

48:I[206516,[“/_next/static/chunks/051aanbhrv4br.js”,“/_next/static/chunks/0mizr60h7ayzt.js”,“/_next/static/chunks/0v9lm1dmbdoo-.js”,“/_next/static/chunks/0rxr1j1j3j-.r.js”,“/_next/static/chunks/02ftybezfvqjd.js”,“/_next/static/chunks/0.v9ksvnnj8ia.js”,“/_next/static/chunks/0bn6id96nx3k.js",“/_next/static/chunks/13ybnhn37c.tc.js”,“/_next/static/chunks/0_fnrdtruz8uf.js”,“/_next/static/chunks/0r6l15utt1mwb.js”,“/_next/static/chunks/0dm9a5into854.js”,"/_next/static/chunks/07k6hqoibtcn.js”,“/next/static/chunks/0b4cao.4y…j.js”,“/_next/static/chunks/02i-n28z7kjd0.js”],“default”]