backlog-summary

编号. 必须在用户请求“获取待办事项”、“列出待办事项”、“显示待办事项”、“待办事项内容”、“待办事项摘要”、“列出Jira事项”、“显示项目中的事项”、“待办事项有哪些”、“显示冲刺事项”、“活跃冲刺”、“过去冲刺”或需要快速查看多个事项时使用。用于批量事项列表 - 使用jira-issue获取单个事项详情。

📖 中文导读:编号. 必须在用户请求“获取待办事项”、“列出待办事项”、“显示待办事项”、“待办事项内容”、“待办事项摘要”、“列出Jira事项”、“显示项目中的事项”、“待办事项有哪些”、“显示冲刺事项”、“活跃冲刺”、“过去冲刺”或需要快速查看多个事项时使用。用于批量事项列表 - 使用jira-issue获取单个事项详情。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: backlog-summary description: This skill MUST be used when the user asks to "get backlog", "list backlog issues", "show backlog", "what's in the backlog", "backlog summary", "list Jira issues", "show issues in project", "what issues are pending", "show sprint issues", "active sprint", "past sprints", or needs a quick overview of multiple issues. Use this for bulk issue listing - use jira-issue for single issue details.

Jira Backlog Summary

Fetch a token-efficient summary of issues from Jira with sprint-aware caching. Returns only essential fields: issue key, status, labels, and summary.

Quick Start

Use the Python script at scripts/fetch_backlog.py:

# Get all issues in project (default 50)
python scripts/fetch_backlog.py EFT

# Get only backlog issues (not in any sprint)
python scripts/fetch_backlog.py EFT --scope backlog

# Get active sprint issues
python scripts/fetch_backlog.py EFT --scope active-sprint

# Get issues from past/closed sprints
python scripts/fetch_backlog.py EFT --scope past-sprints

Scope Options

Scope Description Cache TTL
all (default) All issues Auto-categorized
backlog Issues not in any sprint 12 hours
active-sprint Issues in current sprint 1 hour
past-sprints Issues from closed sprints 24 hours

Filter Examples

Scope + Label Filters

# Backlog Vue issues
python scripts/fetch_backlog.py EFT --scope backlog --label vue

# Active sprint excluding legacy
python scripts/fetch_backlog.py EFT --scope active-sprint --exclude-label legacy

# Past sprint issues that are done
python scripts/fetch_backlog.py EFT --scope past-sprints --status Done

Status Filters

# Only open backlog issues
python scripts/fetch_backlog.py EFT --scope backlog --status Open --status "To Do"

# Active sprint, not done
python scripts/fetch_backlog.py EFT --scope active-sprint --exclude-status Done

Output Formats

Compact (default)

Most token-efficient. One line per issue:

EFT-123|Open|vue,frontend|Implement dark mode toggle
EFT-124|In Progress|-|Fix login validation

Format: KEY|status|labels|summary (labels - if none)

JSON

python scripts/fetch_backlog.py EFT --format json

Returns compact JSON array for programmatic use.

Text

python scripts/fetch_backlog.py EFT --format text

Multi-line human-readable format.

Sprint-Aware Caching

Issues are cached in three categories with different TTLs:

Category TTL Use Case
active_sprint 1 hour Issues change frequently during active sprints
backlog 12 hours Backlog items change less frequently
past_sprints 24 hours Closed sprint issues rarely change

Cache Management

# View cache status
python shared/jira_cache.py info

# Clear all issue cache
python shared/jira_cache.py clear-issues

# Clear only backlog cache
python shared/jira_cache.py clear-issues --category backlog

# Clear only active sprint cache for project
python shared/jira_cache.py clear-issues -p EFT --category active_sprint

# Move issues to past_sprints when sprint closes
python shared/jira_cache.py close-sprint -p EFT --sprint-id 123

Discovery Commands

List available filter values:

# List sprints for project
python scripts/fetch_backlog.py EFT --list-sprints

# List statuses for project
python scripts/fetch_backlog.py EFT --list-statuses

# List available labels
python scripts/fetch_backlog.py EFT --list-labels

Environment Setup

Requires three environment variables:

  • JIRA_BASE_URL - e.g., https://yoursite.atlassian.net
  • JIRA_EMAIL - Your Jira account email
  • JIRA_API_TOKEN - API token from Atlassian account settings

Token Efficiency

This skill is optimized for minimal token usage:

  • Only fetches: key, status, labels, summary (no description, comments, etc.)
  • Compact output uses pipe delimiters
  • Default limit of 50 issues prevents oversized responses
  • Sprint-aware caching reduces API calls

For detailed single-issue information, use the jira-issue skill instead.

Reference

For complete filter options and JQL examples, see references/options-reference.md.