--- name: Issue Manager slug: issue-manager category: Automation description: Issue Manager provides an interactive menu-driven interface for issue CRUD operations via the ccw issue CLI. Use it to list, view, edit, delete, bulk update, and manage issue history. github: "https://github.com/catlog22/Claude-Code-Workflow/tree/main/.claude/skills/issue-manage" language: TypeScript stars: 2135 forks: 164 install: "npx degit https://github.com/catlog22/Claude-Code-Workflow/tree/main/.claude/skills/issue-manage ~/.claude/skills/issue-manage" installs_to: ~/.claude/skills/issue-manage source_path: .claude/skills/issue-manage/SKILL.md collection_size: 25 category_size: 1523 collection_url: "https://dirskills.com/collections/catlog22/Claude-Code-Workflow" added: 2026-08-18T06:58:33.439Z last_synced: 2026-08-18T06:58:33.439Z canonical_url: "https://dirskills.com/skills/issue-manager" --- # Issue Manager Issue Manager provides an interactive menu-driven interface for issue CRUD operations via the ccw issue CLI. Use it to list, view, edit, delete, bulk update, and manage issue history. **Install:** ```bash npx degit https://github.com/catlog22/Claude-Code-Workflow/tree/main/.claude/skills/issue-manage ~/.claude/skills/issue-manage ``` ## README # 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 ```bash # Core operations ccw issue list # List active issues ccw issue list --json # Get issue details ccw issue history # List completed issues (from history) ccw issue history --json # Completed issues as JSON ccw issue status # Detailed status ccw issue init --title "..." # Create issue ccw issue task --title "..." # Add task ccw issue bind # Bind solution ccw issue update --status completed # Complete & auto-archive # Solution queries ccw issue solution # List solutions for a single issue ccw issue solution --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 # Add to queue ccw issue queue list # Queue history ccw issue queue switch # Switch queue ccw issue queue archive # Archive queue ccw issue queue delete # Delete queue ccw issue next # Get next task ccw issue done # 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**: 1. Ask filter preferences → `ccw issue list --json` 2. Display table: ID | Status | Priority | Title 3. 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**: 1. Fetch `ccw issue status --json` 2. Display issue + solutions + tasks 3. 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**: 1. Select field to edit 2. Show current value 3. Collect new value via AskUserQuestion 4. 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**: 1. Confirm deletion via AskUserQuestion 2. Remove from `issues.jsonl` 3. Clean up `solutions/.jsonl` 4. 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**: 1. Fetch `ccw issue history --json` 2. Display table: ID | Completed At | Title 3. Optional: Filter by date range **Auto-Archive**: When issue status → `completed`: - Issue moves from `issues.jsonl` → `issue-history.jsonl` - Solutions remain in `solutions/.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 ```javascript // 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 ```javascript // 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 ```javascript 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 ```javascript // 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/.jsonl` | Solutions per issue | | `.workflow/issues/queues/index.json` | Queue index (multi-queue) | | `.workflow/issues/queues/.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