grandcamel/jira-operations

JIRA Operations Skill

Cache management, request batching, and operational utilities for JIRA Assistant.

Risk Levels

| Operation | Risk | Notes | |-----------|------|-------| | Discover project | - | Read-only analysis | | Cache status | - | Read-only | | Cache warm | - | Populates local cache | | Cache clear (dry-run) | - | Preview only | | Cache clear | ! | Local cache cleared, will re-fetch |

Risk Legend: - Safe, read-only | ! Caution, modifiable | !! Warning, destructive but recoverable | !!! Danger, irreversible

When to Use This Skill

Use this skill when you need to:

• Discover project context: Auto-discover project metadata, workflows, and usage patterns
• Monitor cache status: Check cache size, entry counts, and hit rates
• Clear cache data: Remove stale or sensitive cached data
• Pre-warm cache: Load commonly accessed data for better performance
• Optimize performance: Reduce API calls through effective caching
• Troubleshoot slowness: Diagnose cache-related performance issues

What This Skill Does

IMPORTANT: Always use the jira-as CLI. Never run Python scripts directly.

• Project Discovery: Discover project metadata, workflows, and patterns for intelligent defaults
• Cache Status Monitoring: Display cache statistics (size, entries, hit rates)
• Cache Clearing: Remove cache entries by category, pattern, or all at once
• Cache Warming: Pre-load project metadata and field definitions
• Request Batching: Parallel request execution for bulk operations (programmatic API)

Quick Start

# Discover project context (saves to skill directory by default)
jira-as ops discover-project PROJ

# Check cache status
jira-as ops cache-status

# Clear all cache
jira-as ops cache-clear --force

# Warm cache with all metadata
jira-as ops cache-warm --all

Common Tasks (30-Second Solutions)

Check cache status

# Basic status
jira-as ops cache-status

# Output as JSON
jira-as ops cache-status --json

# Verbose output (-v is short for --verbose)
jira-as ops cache-status -v
jira-as ops cache-status --verbose

Warm the cache

# Cache project list
jira-as ops cache-warm --projects

# Cache field definitions
jira-as ops cache-warm --fields

# Cache assignable users (requires project context)
jira-as ops cache-warm --users

# Cache all available metadata with verbose output
jira-as ops cache-warm --all --verbose

# Output as JSON
jira-as ops cache-warm --all --json

Clear cache

# Clear all cache (with confirmation)
jira-as ops cache-clear

# Clear all cache (skip confirmation, -f is short for --force)
jira-as ops cache-clear -f
jira-as ops cache-clear --force

# Clear only issue cache (-c is short for --category)
# Categories: issue, project, user, field, search, default
jira-as ops cache-clear -c issue -f
jira-as ops cache-clear --category issue --force

# Preview what would be cleared
jira-as ops cache-clear --dry-run

# Clear keys matching pattern
jira-as ops cache-clear --pattern "PROJ-*" -c issue -f

# Clear specific cache key (requires --category)
jira-as ops cache-clear --key "PROJ-123" -c issue -f

# Output as JSON
jira-as ops cache-clear -f --json

Discover project context

# Discover and output project context (text format)
jira-as ops discover-project PROJ

# Output as JSON (-o is short for --output)
jira-as ops discover-project PROJ -o json
jira-as ops discover-project PROJ --output json

# Verbose output with detailed analysis (-v is short for --verbose)
jira-as ops discover-project PROJ -v

# Custom sample size and period (-s, -d are short forms)
jira-as ops discover-project PROJ -s 200 -d 60
jira-as ops discover-project PROJ --sample-size 200 --days 60

See Commands Guide for complete documentation.

Available Commands

All commands support --help for full documentation.

| Command | Description | |---------|-------------| | jira-as ops discover-project | Discover project metadata, workflows, and patterns | | jira-as ops cache-status | Display cache statistics (size, entries, hit rate) | | jira-as ops cache-clear | Clear cache entries (all, by category, or by pattern) | | jira-as ops cache-warm | Pre-warm cache with commonly accessed data |

Exit Codes

| Code | Meaning | |------|---------| | 0 | Success | | 1 | General error | | 2 | Configuration error | | 3 | Cache database error | | 4 | Network error |

Configuration

Cache is stored in ~/.jira-skills/cache/ with configurable TTL per category.

See Configuration Guide for details.

Shared Libraries

This skill uses shared infrastructure from jira-as:

| Library | Description | |---------|-------------| | cache.py | SQLite-based caching with TTL and LRU eviction | | request_batcher.py | Parallel request batching for bulk operations |

See API Reference for programmatic usage.

Documentation

• Quick Start Guide - Get started in 5 minutes
• Scripts Guide - Detailed script documentation
• API Reference - Programmatic cache and batcher APIs
• Configuration - TTL settings
• Troubleshooting - Common issues and solutions
• Security - Cache security considerations
• Best Practices - Optimization patterns