sprint-report
This skill MUST be used when the user asks for "sprint report", "sprint summary", "sprint burndown", "sprint velocity", "sprint metrics", "how is the sprint going", "sprint health", "sprint completion", or needs a detailed analysis of sprint progress and performance.
📖 中文导读:This skill MUST be used when the user asks for "sprint report", "sprint summary", "sprint burndown", "sprint velocity", "sprint metrics", "how is the sprint going", "sprint health", "sprint completion", or needs a detailed analysis of sprint progress and performance. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: sprint-report description: This skill MUST be used when the user asks for "sprint report", "sprint summary", "sprint burndown", "sprint velocity", "sprint metrics", "how is the sprint going", "sprint health", "sprint completion", or needs a detailed analysis of sprint progress and performance.
Sprint Report
Generate detailed sprint reports with progress metrics, issue breakdown, and velocity data.
Quick Start
Use the Python script at scripts/sprint_report.py:
# Report for active sprint
python scripts/sprint_report.py PROJ
# Report for specific sprint
python scripts/sprint_report.py PROJ --sprint-id 123
# Include detailed issue breakdown
python scripts/sprint_report.py PROJ --detailed
# Compare with previous sprints (velocity)
python scripts/sprint_report.py PROJ --velocity
Options
| Option | Description |
|---|---|
PROJECT |
Project key (required) |
--sprint-id ID |
Report for specific sprint (default: active) |
--detailed |
Include issue-by-issue breakdown |
--velocity |
Include velocity comparison with past sprints |
--format FORMAT |
Output: compact (default), text, json |
Report Sections
Progress Summary
- Issues: done / in-progress / todo
- Story points: completed / remaining
- Percentage complete
Issue Breakdown (with --detailed)
- Issues by status
- Issues by type (Bug, Story, Task, etc.)
- Top blockers/risks
Velocity (with --velocity)
- Current sprint vs average
- Last 3 sprints comparison
- Trend indicator
Output Examples
Compact (default)
SPRINT|Sprint 23|active|2024-01-15|2024-01-29|60%
ISSUES|12/20 done|5 in-progress|3 todo
POINTS|21/34|13 remaining
With Velocity
SPRINT|Sprint 23|active|2024-01-15|2024-01-29|60%
ISSUES|12/20 done|5 in-progress|3 todo
POINTS|21/34|13 remaining
VELOCITY|34|avg:32|trend:up
Text Format
Sprint Report: Sprint 23
========================
Status: active
Period: 2024-01-15 to 2024-01-29
Progress
--------
Issues: 12/20 done (60%)
- In Progress: 5
- To Do: 3
Story Points: 21/34 completed
- Remaining: 13 points
Velocity
--------
Current Sprint: 34 points planned
Average (3 sprints): 32 points
Trend: Improving
Environment Setup
Requires three environment variables:
JIRA_BASE_URL- e.g.,https://yoursite.atlassian.netJIRA_EMAIL- Your Jira account emailJIRA_API_TOKEN- API token from Atlassian account settings
Reference
For complete options and metrics explanation, see references/options-reference.md.