extract-issues

Extract Issues Skill

Extract actionable issues from note canvas content using semantic analysis and confidence scoring.

Quick Start

Use this skill when:

• User finishes brainstorming in note canvas
• AI detects potential work items in note content
• User explicitly requests issue extraction (/extract-issues)

Example:

User writes in note:
"We need to implement JWT authentication and add rate limiting
to the API. Also fix the login bug where users can't log in with email."

AI extracts:
- Issue 1: "Implement JWT authentication" (RECOMMENDED)
- Issue 2: "Add API rate limiting" (RECOMMENDED)
- Issue 3: "Fix email login bug" (RECOMMENDED - explicit bug mention)

Workflow

1. Analyze Note Content

   • Parse note blocks (paragraphs, lists, headings)
   • Identify action items using verb patterns (implement, fix, add, create)
   • Detect explicit issue references ("bug", "feature", "task")

2. Extract Candidate Issues

   • For each potential issue:
     • Extract name (concise title, ≤100 chars)
     • Extract description (context from surrounding text)
     • Identify block_id for source linking
     • Detect labels from keywords (backend, frontend, security, etc.)
     • Infer priority from urgency markers (critical, urgent, nice-to-have)

3. Score Confidence

   • RECOMMENDED: Clear action item with explicit verb and context
     • Example: "Implement user authentication with JWT tokens"
   • DEFAULT: Implied action from discussion context
     • Example: "Authentication should use JWT" (implies implementation)
   • ALTERNATIVE: Possible interpretation, needs clarification
     • Example: "Maybe we should consider caching?" (tentative)

4. Return Structured Output

   • JSON array of issues with confidence tags
   • Preserve source block links
   • Include rationale for each confidence score

Output Format

{
  "issues": [
    {
      "name": "Implement JWT authentication",
      "description": "Add JWT-based authentication with refresh tokens to replace session cookies",
      "confidence": "RECOMMENDED",
      "source_block_id": "block-abc123",
      "labels": ["backend", "security"],
      "priority": "high",
      "rationale": "Clear implementation task with specific requirements (JWT, refresh tokens)"
    },
    {
      "name": "Add API rate limiting",
      "description": "Implement rate limiting middleware to prevent API abuse",
      "confidence": "RECOMMENDED",
      "source_block_id": "block-def456",
      "labels": ["backend", "infrastructure"],
      "priority": "medium",
      "rationale": "Explicit action item, standard security practice"
    },
    {
      "name": "Fix email login bug",
      "description": "Users cannot log in using email addresses, investigate validation logic",
      "confidence": "RECOMMENDED",
      "source_block_id": "block-ghi789",
      "labels": ["backend", "bug"],
      "priority": "critical",
      "rationale": "Explicit bug mention, blocks user access"
    }
  ],
  "summary": "Extracted 3 issues from note content",
  "total_blocks_analyzed": 8
}