enhance-issue

Enhance Issue Skill

Automatically enhance issue metadata using AI analysis of title and description.

Quick Start

Use this skill when:

• User creates minimal issue (only title)
• Issue lacks labels, priority, or acceptance criteria
• User requests AI enhancement (/enhance-issue)

Example:

User creates issue:
Title: "Login not working"

AI enhances:
- Labels: ["bug", "backend", "authentication", "critical"]
- Priority: "critical" (blocks user access)
- Acceptance Criteria:
  - [ ] Users can log in with valid credentials
  - [ ] Error messages are clear for invalid credentials
  - [ ] Session persists after login

Workflow

1. Analyze Issue Context

   • Parse title for keywords (fix, implement, bug, feature)
   • Analyze description for technical details
   • Check for urgency markers (critical, urgent, blocking)
   • Identify domain from keywords (auth, api, ui, db)

2. Suggest Labels

   • Type: bug, feature, enhancement, documentation, chore
   • Domain: backend, frontend, infrastructure, security
   • Technology: python, typescript, react, postgresql
   • Status: needs-investigation, blocked, ready
   • Use RECOMMENDED for clear matches, DEFAULT for inferred

3. Infer Priority

   • Critical: Security vulnerabilities, data loss, complete feature breakage
   • High: Major functionality broken, significant user impact
   • Medium: Partial functionality affected, workarounds exist
   • Low: Minor issues, cosmetic improvements, nice-to-have features

4. Generate Acceptance Criteria

   • Extract implied requirements from description
   • Add standard criteria based on issue type:
     • Bugs: Reproduction steps, expected behavior, error handling
     • Features: Happy path, edge cases, error states
   • Format as checklist for task tracking

Output Format

{
  "suggested_labels": [
    {"label": "bug", "confidence": "RECOMMENDED", "rationale": "Title contains 'not working'"},
    {"label": "backend", "confidence": "RECOMMENDED", "rationale": "Login is server-side functionality"},
    {"label": "authentication", "confidence": "RECOMMENDED", "rationale": "Login relates to auth"},
    {"label": "critical", "confidence": "RECOMMENDED", "rationale": "Blocks user access"}
  ],
  "suggested_priority": {
    "priority": "critical",
    "confidence": "RECOMMENDED",
    "rationale": "Complete feature breakage preventing user access"
  },
  "acceptance_criteria": [
    {"text": "Users can log in with valid email and password", "confidence": "RECOMMENDED"},
    {"text": "Error messages are displayed for invalid credentials", "confidence": "RECOMMENDED"},
    {"text": "Session persists after successful login", "confidence": "DEFAULT"},
    {"text": "Login form validates input client-side", "confidence": "DEFAULT"}
  ],
  "estimated_complexity": {
    "level": "medium",
    "confidence": "DEFAULT",
    "rationale": "Likely requires debugging auth flow, not full reimplementation"
  }
}