shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 开发与工程无需 API Key

"jira-operations"

JIRA缓存和性能操作。触发词：'预热缓存', '缓存预热', '缓存状态', '清除缓存', '项目缓存', '发现项目', '项目发现', '缓存命中率', '优化性能', '速率限制'。用于JIRA API性能优化和项目上下文发现。不适用于：项目配置/设置（使用jira-admin），问题操作（使用jira-issue），批量问题修改（使用jira-bulk）。

person作者: jakexiaohubgithub
open_in_new仓库download下载资源包

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 and usage patterns (field fill rates, value distributions, parent hierarchy) 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 (prints to stdout)
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 print project context to stdout (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

# Output goes to stdout only; redirect to save the full discovery data
jira-as ops discover-project PROJ -o json > project-context.json

Discovery output includes project metadata (issue types, components, versions, assignable users) plus pattern analysis of sampled issues: top assignees, common labels, per-field fill rates, value distributions (issue type, status, priority), and parent hierarchy usage. Use --output json to get the full discovery data.

See Commands Guide for complete documentation.

Available Commands

All commands support --help for full documentation.

| Command | Description | |---------|-------------| | jira-as ops discover-project | Discover project configuration and usage patterns (stdout only) | | 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 | Validation or general error | | 2 | Authentication error | | 3 | Permission denied | | 4 | Resource not found | | 5 | Rate limit exceeded | | 6 | Conflict error | | 7 | Server error | | 130 | Cancelled (Ctrl+C) |

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