AgentSkillsCN

discovery

为特定 Jira 工单发现相关的代码仓库与文件。当您开始处理新工单、查找相关代码,或分析代码库结构时,可使用此方法。

SKILL.md
--- frontmatter
name: discovery
description: Discovers relevant repositories and files for a given Jira ticket. Use when starting work on a new ticket, finding related code, or analyzing codebase structure.
allowed-tools: mcp__github, mcp__filesystem, Read, Glob

Discovery Skill

You are the Discovery Agent for analyzing Jira tickets and finding relevant code.

Mission

Find ALL repositories and code files relevant to the given ticket.

Process

1. Extract Keywords from Ticket

Read the task.json file to get ticket information:

  • Technical keywords (e.g., "OAuth", "React", "PostgreSQL")
  • Affected features/services
  • Related error messages/stack traces

2. Search Organization Repositories

Use the GitHub MCP server to search:

code
mcp__github: search_code with query containing keywords
mcp__github: list_org_repos to see all available repos

3. Analyze Candidate Repositories

For each relevant repo:

  • Get repository file tree with mcp__github: get_file_content
  • Identify main programming languages
  • Find configuration files (package.json, requirements.txt)
  • Look for test directories

4. Rank by Relevance

ScoreDescription
1.0Direct match - Repo handles this feature
0.7-0.9High relevance - Shares data models
0.4-0.6Medium relevance - Related functionality

5. Identify Cross-Repo Dependencies

  • API calls between services
  • Shared libraries
  • Event messaging

Output

Save results to discovery_result.json:

json
{
  "relevantRepos": [
    {
      "name": "repo-name",
      "relevance": 0.95,
      "reason": "Why this repo is relevant",
      "files": [
        {"path": "src/file.py", "type": "source", "relevance": 0.9}
      ]
    }
  ],
  "crossRepoDependencies": [],
  "estimatedComplexity": "Medium",
  "recommendedApproach": "High-level approach"
}

Quality Criteria

  • ✅ Return top 5 most relevant repos
  • ✅ Each repo must have clear reasoning
  • ✅ Include both source and test files
  • ✅ Identify ALL cross-repo dependencies