Claude Code for OSS Issue Triage Workflow Tutorial

#!/usr/bin/env python3
"""GitHub Issue Triage Bot using Claude Code"""

import os
import re
from datetime import datetime

# Configuration
REPO_OWNER = os.getenv("GITHUB_REPO_OWNER")
REPO_NAME = os.getenv("GITHUB_REPO_NAME")
GITHUB_TOKEN = os.getenv("GITHUB_TOKEN")

# Classification patterns
BUG_PATTERNS = [
    r'\b(crash|error|bug|broken|fail|not working)\b',
    r'Steps to reproduce',
    r'Traceback|stack trace',
]

FEATURE_PATTERNS = [
    r'\b(feature|add|support|implement|enhancement)\b',
    r'would be nice',
    r'should be able to',
]

DOC_PATTERNS = [
    r'\b(docs?|documentation|typo|spelling)\b',
    r'\.md$',
]

QUESTION_PATTERNS = [
    r'\?$',
    r'\b(how (to|can)|is it possible|can i)\b',
]

PRIORITY_PATTERNS = {
    'P0': [r'\b(crash|data loss|security|vulnerability|critical)\b'],
    'P1': [r'\b(major|broken|significant workaround)\b'],
    'P2': [r'\b(bug|issue|problem)\b'],
    'P3': [r'\b(cosmetic|minor|inconvenience)\b'],
}

def classify_issue(title, body):
    """Classify issue type based on content"""
    text = f"{title} {body}".lower()
    
    if any(re.search(p, text) for p in BUG_PATTERNS):
        return "bug"
    elif any(re.search(p, text) for p in FEATURE_PATTERNS):
        return "enhancement"
    elif any(re.search(p, text) for p in DOC_PATTERNS):
        return "documentation"
    elif any(re.search(p, text) for p in QUESTION_PATTERNS):
        return "question"
    else:
        return "other"

def assign_priority(title, body):
    """Assign priority based on severity indicators"""
    text = f"{title} {body}".lower()
    
    for priority, patterns in PRIORITY_PATTERNS.items():
        if any(re.search(p, text) for p in patterns):
            return priority
    return "P2"  # Default priority

def extract_labels(issue_type, priority):
    """Generate labels based on classification"""
    labels = []
    
    # Type labels
    type_labels = {
        "bug": ["type: bug"],
        "enhancement": ["type: feature"],
        "documentation": ["type: docs"],
        "question": ["type: question"],
        "other": ["type: other"],
    }
    labels.extend(type_labels.get(issue_type, []))
    
    # Priority labels
    labels.append(f"priority: {priority}")
    
    return labels

# Main triage function
def triage_issue(issue_number):
    """Process a single issue through the triage workflow"""
    # Fetch issue details (via GitHub CLI or API)
    # This is where Claude Code integrates
    
    title = get_issue_title(issue_number)
    body = get_issue_body(issue_number)
    
    # Run classification
    issue_type = classify_issue(title, body)
    priority = assign_priority(title, body)
    labels = extract_labels(issue_type, priority)
    
    # Add triage comment
    triage_comment = f"""**Triage Complete**

- **Type:** {issue_type}
- **Priority:** {priority}
- **Labels:** {', '.join(labels)}

_This issue was automatically triaged by Claude Code._"""
    
    # Apply labels and comment
    add_labels(issue_number, labels)
    add_comment(issue_number, triage_comment)
    
    return {"type": issue_type, "priority": priority}