AgentSkillsCN

jira-operations

JIRA 缓存与性能优化。触发条件包括：“预热缓存”、“缓存预热”、“缓存状态”、“清除缓存”、“缓存预热”、“为项目缓存”、“发现项目”、“项目发现”、“缓存命中率”、“优化性能”、“速率限制”。适用于 JIRA API 性能优化与项目上下文的深度挖掘。不适用于：项目配置/设置（请使用 jira-admin），问题操作（请使用 jira-issue），批量问题修改（请使用 jira-bulk）。

SKILL.md
--- frontmatter
name: "jira-operations"
description: "JIRA cache and performance operations. TRIGGERS: 'warm the cache', 'warm cache', 'cache status', 'clear cache', 'cache warm', 'cache for project', 'discover project', 'project discovery', 'cache hit rate', 'optimize performance', 'rate limit'. Use for JIRA API performance optimization and project context discovery. NOT FOR: project configuration/settings (use jira-admin), issue operations (use jira-issue), bulk issue modifications (use jira-bulk)."
version: "1.0.0"
author: "jira-assistant-skills"
license: "MIT"
allowed-tools: ["Bash", "Read", "Glob", "Grep"]
triggers:
  - "Cache hit rate drops below 50%"
  - "JIRA API responses slower than 2 seconds"
  - "Setting up new JIRA instance"
  - "Before bulk operations (warm cache first)"
  - "After modifying projects (invalidate cache)"
  - "Troubleshooting 429 rate limit errors"

JIRA Operations Skill

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

Risk Levels

OperationRiskNotes
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

bash
# 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

bash
# 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

bash
# 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

bash
# 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

bash
# 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.

CommandDescription
jira-as ops discover-projectDiscover project metadata, workflows, and patterns
jira-as ops cache-statusDisplay cache statistics (size, entries, hit rate)
jira-as ops cache-clearClear cache entries (all, by category, or by pattern)
jira-as ops cache-warmPre-warm cache with commonly accessed data

Exit Codes

CodeMeaning
0Success
1General error
2Configuration error
3Cache database error
4Network 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:

LibraryDescription
cache.pySQLite-based caching with TTL and LRU eviction
request_batcher.pyParallel request batching for bulk operations

See API Reference for programmatic usage.

Documentation