Issue Management Skill

Interactive menu-driven interface for issue CRUD operations via ccw issue CLI.

Quick Start

Ask me:

• "Show all issues" → List with filters

• "View issue GH-123" → Detailed inspection

• "Edit issue priority" → Modify fields

• "Delete old issues" → Remove with confirmation

• "Bulk update status" → Batch operations

• "Show completed issues" → View issue history

• "Archive old issues" → Move to history

CLI Endpoints

Core operations

ccw issue list # List active issues ccw issue list <id> --json # Get issue details ccw issue history # List completed issues (from history) ccw issue history --json # Completed issues as JSON ccw issue status <id> # Detailed status ccw issue init <id> --title "..." # Create issue ccw issue task <id> --title "..." # Add task ccw issue bind <id> <solution-id> # Bind solution ccw issue update <id> --status completed # Complete & auto-archive

Solution queries

ccw issue solution <id> # List solutions for a single issue ccw issue solution <id> --brief # Brief: solution_id, files_touched, task_count ccw issue solutions # Batch list all bound solutions ccw issue solutions --status planned --brief # Filter by issue status

Queue management

ccw issue queue # List current queue ccw issue queue add <id> # Add to queue ccw issue queue list # Queue history ccw issue queue switch <queue-id> # Switch queue ccw issue queue archive # Archive queue ccw issue queue delete <queue-id> # Delete queue ccw issue next # Get next task ccw issue done <queue-id> # Mark completed ccw issue update --from-queue # Sync statuses from queue

Operations

1. LIST 📋

Filter and browse issues:

┌─ Filter by Status ─────────────────┐ │ □ All □ Registered │ │ □ Planned □ Queued │ │ □ Executing □ Completed │ └────────────────────────────────────┘

Flow:

• Ask filter preferences → ccw issue list --json

• Display table: ID | Status | Priority | Title

• Select issue for detail view

2. VIEW 🔍

Detailed issue inspection:

┌─ Issue: GH-123 ─────────────────────┐ │ Title: Fix authentication bug │ │ Status: planned | Priority: P2 │ │ Solutions: 2 (1 bound) │ │ Tasks: 5 pending │ └─────────────────────────────────────┘

Flow:

• Fetch ccw issue status <id> --json

• Display issue + solutions + tasks

• Offer actions: Edit | Plan | Queue | Delete

3. EDIT ✏️

Modify issue fields:

Field Options

Title Free text

Priority P1-P5

Status registered → completed

Context Problem description

Labels Comma-separated

Flow:

• Select field to edit

• Show current value

• Collect new value via AskUserQuestion

• Update .workflow/issues/issues.jsonl

4. DELETE 🗑️

Remove with confirmation:

⚠️ Delete issue GH-123? This will also remove:

• Associated solutions
• Queued tasks

[Delete] [Cancel]

Flow:

• Confirm deletion via AskUserQuestion

• Remove from issues.jsonl

• Clean up solutions/<id>.jsonl

• Remove from queue.json

5. HISTORY 📚

View and manage completed issues:

┌─ Issue History ─────────────────────┐ │ ID Completed Title │ │ ISS-001 2025-12-28 12:00 Fix bug │ │ ISS-002 2025-12-27 15:30 Feature │ └──────────────────────────────────────┘

Flow:

• Fetch ccw issue history --json

• Display table: ID | Completed At | Title

• Optional: Filter by date range

Auto-Archive: When issue status → completed :

• Issue moves from issues.jsonl → issue-history.jsonl

• Solutions remain in solutions/<id>.jsonl

• Queue items marked completed

6. BULK 📦

Batch operations:

Operation Description

Update Status Change multiple issues

Update Priority Batch priority change

Add Labels Tag multiple issues

Delete Multiple Bulk removal

Queue All Planned Add all planned to queue

Retry All Failed Reset failed tasks

Sync from Queue Update statuses from active queue

Workflow

┌────────────────────────────────────────────────┐ │ Main Menu │ │ ┌────┐ ┌────┐ ┌────┐ ┌─────┐ ┌────┐ │ │ │List│ │View│ │Edit│ │Hist.│ │Bulk│ │ │ └──┬─┘ └──┬─┘ └──┬─┘ └──┬──┘ └──┬─┘ │ └─────┼──────┼──────┼──────┼───────┼─────────────┘ │ │ │ │ │ ▼ ▼ ▼ ▼ ▼ Filter Detail Fields History Multi Select Actions Update Browse Select │ │ │ │ │ └──────┴──────┴──────┴───────┘ │ ▼ Back to Menu

Issue Lifecycle:

registered → planned → queued → executing → completed │ ▼ issue-history.jsonl

Implementation Guide

Entry Point

// Parse input for issue ID const issueId = input.match(/^([A-Z]+-\d+|ISS-\d+)/i)?.[1];

// Show main menu await showMainMenu(issueId);

Main Menu Pattern

// 1. Fetch dashboard data const issues = JSON.parse(Bash('ccw issue list --json') || '[]'); const history = JSON.parse(Bash('ccw issue history --json 2>/dev/null') || '[]'); const queue = JSON.parse(Bash('ccw issue queue --json 2>/dev/null') || '{}');

// 2. Display summary console.log(Active: ${issues.length} | Completed: ${history.length} | Queue: ${queue.pending_count || 0} pending);

// 3. Ask action via AskUserQuestion const action = AskUserQuestion({ questions: [{ question: 'What would you like to do?', header: 'Action', options: [ { label: 'List Issues', description: 'Browse active issues' }, { label: 'View Issue', description: 'Detail view (includes history)' }, { label: 'Edit Issue', description: 'Modify fields' }, { label: 'Bulk Operations', description: 'Batch actions' } ] }] });

// 4. Route to handler

Filter Pattern

const filter = AskUserQuestion({ questions: [{ question: 'Filter by status?', header: 'Filter', multiSelect: true, options: [ { label: 'All', description: 'Show all' }, { label: 'Registered', description: 'Unplanned' }, { label: 'Planned', description: 'Has solution' }, { label: 'Executing', description: 'In progress' } ] }] });

Edit Pattern

// Select field const field = AskUserQuestion({...});

// Get new value based on field type // For Priority: show P1-P5 options // For Status: show status options // For Title: accept free text via "Other"

// Update file const issuesPath = '.workflow/issues/issues.jsonl'; // Read → Parse → Update → Write

Data Files

File Purpose

.workflow/issues/issues.jsonl

Active issue records

.workflow/issues/issue-history.jsonl

Completed issues (archived)

.workflow/issues/solutions/<id>.jsonl

Solutions per issue

.workflow/issues/queues/index.json

Queue index (multi-queue)

.workflow/issues/queues/<queue-id>.json

Individual queue files

Error Handling

Error Resolution

No issues found Suggest /issue:new to create

Issue not found Show available issues, re-prompt

Write failure Check file permissions

Queue error Display ccw error message

Related Commands

• /issue:new

• Create structured issue

• /issue:plan

• Generate solution

• /issue:queue

• Form execution queue

• /issue:execute

• Execute tasks