Initial commit

2025-11-30 08:40:02 +08:00
commit 0a8a6c982f
21 changed files with 4153 additions and 0 deletions
--- a/skills/jira-cli/references/workflows.md
+++ b/skills/jira-cli/references/workflows.md
@@ -0,0 +1,290 @@
+# Jira CLI - Common Workflows
+
+This file contains practical workflow examples for common Jira use cases and team collaboration scenarios.
+
+## Daily Standup Preparation
+
+Get quick answers for your daily standup:
+
+```bash
+# What did I work on yesterday?
+jira issue list -a$(jira me) --updated -1d
+
+# What am I working on today?
+jira issue list -a$(jira me) -s"In Progress"
+
+# What tickets did I close this week?
+jira issue list -a$(jira me) -sDone --updated week
+
+# Any blockers? (high priority issues assigned to me)
+jira issue list -a$(jira me) -yHigh -s~Done
+```
+
+## Sprint Planning
+
+Prepare for and manage sprint planning:
+
+```bash
+# High priority unassigned tickets (need assignment)
+jira issue list -ax -yHigh
+
+# Backlog items ready for sprint (ordered by rank like UI)
+jira issue list -s"Ready for Dev" --order-by rank --reverse
+
+# Current sprint progress
+jira sprint list --current
+
+# Current sprint with my tasks only
+jira sprint list --current -a$(jira me)
+
+# See what's planned for next sprint
+jira sprint list --next
+
+# Check sprint capacity (how many issues)
+jira sprint list SPRINT_ID --plain --no-headers | wc -l
+```
+
+## Code Review Workflow
+
+Integrate Jira with your code review process:
+
+```bash
+# 1. Create ticket for review
+jira issue create -tTask -s"Code review: Feature X"
+
+# 2. Link to related PR
+jira issue link remote ISSUE-1 https://github.com/org/repo/pull/123 "PR #123"
+
+# 3. Move to review status
+jira issue move ISSUE-1 "In Review"
+
+# 4. Add review comments
+jira issue comment add ISSUE-1 "LGTM! Approved changes."
+
+# 5. Close the ticket
+jira issue move ISSUE-1 Done -RFixed
+```
+
+## Bug Triage
+
+Efficient bug triage workflow:
+
+```bash
+# List new bugs from last week
+jira issue list -tBug -sOpen --created -7d
+
+# List critical/high priority bugs
+jira issue list -tBug -yHighest,High -s~Done
+
+# Assign high priority bug to team lead
+jira issue assign BUG-123 "Team Lead"
+
+# Add triage notes
+jira issue comment add BUG-123 "Investigating root cause. Checking logs."
+
+# Update priority and labels
+jira issue edit BUG-123 -yHigh -lproduction -lurgent
+
+# Link to related issues
+jira issue link BUG-123 BUG-100 "is caused by"
+```
+
+## Epic Management Workflow
+
+Working with epics effectively:
+
+```bash
+# Create a new epic for quarterly goals
+jira epic create -n"Q1 2025 Goals" -s"Q1 Goals" -yHigh
+
+# List open epics to see what's in progress
+jira epic list -sOpen
+
+# View all tasks in a specific epic
+jira epic list EPIC-42
+
+# Add new stories to the epic
+jira issue create -tStory -s"User authentication" -PEPIC-42
+jira epic add EPIC-42 STORY-100 STORY-101
+
+# Check epic progress (how many done vs total)
+jira epic list EPIC-42 -sDone --plain --no-headers | wc -l
+jira epic list EPIC-42 --plain --no-headers | wc -l
+
+# Remove completed stories from epic
+jira epic remove STORY-98 STORY-99
+```
+
+## Release Management
+
+Managing releases and versions:
+
+```bash
+# List all releases
+jira release list
+
+# List releases for specific project
+jira release list --project MYPROJECT
+
+# Create issues for a release
+jira issue create -tBug -s"Release blocker" --fix-version v2.0
+
+# Find all issues in a release
+jira issue list --fix-version v2.0
+
+# Find unresolved issues blocking release
+jira issue list --fix-version v2.0 -s~Done
+```
+
+## Team Collaboration
+
+Collaborate effectively with your team:
+
+```bash
+# See what your teammate is working on
+jira issue list -a"John Doe" -s"In Progress"
+
+# Find issues reported by PM for review
+jira issue list -r"Jane PM" -s"To Do" --order-by priority
+
+# Check team's completed work this week
+jira issue list -a~x --updated week -sDone
+
+# Find unassigned high priority work
+jira issue list -ax -yHigh -s"To Do"
+
+# Check who's working on what in current sprint
+jira sprint list --current --plain --columns assignee,key,summary
+```
+
+## Incident Response
+
+Handle production incidents:
+
+```bash
+# Create critical incident ticket
+jira issue create -tBug -s"Production outage: API down" -yHighest -lincident -lproduction --no-input
+
+# Link related issues
+jira issue link INC-1 BUG-789 "is caused by"
+
+# Add status updates
+jira issue comment add INC-1 "Root cause identified. Rolling back deployment."
+
+# Track time spent
+jira issue worklog add INC-1 "2h" --comment "Incident response" --no-input
+
+# Close incident
+jira issue move INC-1 Done -RFixed --comment "Service restored. Post-mortem scheduled."
+```
+
+## Backlog Grooming
+
+Keep your backlog organized:
+
+```bash
+# Find old unassigned tickets (potential cleanup candidates)
+jira issue list -ax --created-before -12w -s"To Do"
+
+# Find tickets with no recent activity
+jira issue list --updated-before -8w -s~Done
+
+# Find tickets missing labels or components
+jira issue list -l~x -C~x
+
+# Update stale tickets in bulk (interactive or scripted)
+for issue in $(jira issue list -ax --created-before -12w --plain --columns key --no-headers); do
+  jira issue edit $issue -s"To Do" --label stale
+done
+```
+
+## Cross-Team Coordination
+
+Working across teams:
+
+```bash
+# Find issues blocked by other teams
+jira issue list -a$(jira me) -lblocked --plain --columns key,summary,status
+
+# Check dependencies in a project
+jira issue list -pOTHERPROJ -a"Dependency Owner"
+
+# See what other teams need from you
+jira issue list -r~$(jira me) -a$(jira me) --plain --columns key,reporter,summary
+
+# Create handoff ticket
+jira issue create -tTask -s"Handoff: Database migration" -CInfra -a"Infrastructure Lead"
+```
+
+## Personal Productivity
+
+Personal task management:
+
+```bash
+# My daily dashboard
+alias jira-today='jira issue list -a$(jira me) -s"In Progress"'
+
+# What I should focus on
+alias jira-priorities='jira issue list -a$(jira me) -yHigh -s~Done --order-by priority'
+
+# What I reported that needs attention
+alias jira-reported='jira issue list -r$(jira me) -s"To Do"'
+
+# Quick add task
+alias jira-task='jira issue create -tTask -a$(jira me)'
+
+# My work this week
+alias jira-week='jira issue list -a$(jira me) --updated week'
+```
+
+## Best Practices
+
+### Efficient Filtering
+
+```bash
+# Combine multiple filters for precision
+jira issue list -a$(jira me) -yHigh -s"In Progress" --created week -lurgent
+
+# Use NOT operator (~) to exclude
+jira issue list -s~Done -s~"In Progress"  # Not done and not in progress
+
+# Time-based queries for recent activity
+jira issue list --updated -2h  # Last 2 hours
+jira issue list --created today  # Created today
+```
+
+### Bulk Operations
+
+```bash
+# Add multiple issues to sprint
+jira sprint add SPRINT_ID $(jira issue list -s"Ready" --plain --columns key --no-headers | head -10 | tr '\n' ' ')
+
+# Batch assign to team members
+for issue in ISSUE-1 ISSUE-2 ISSUE-3; do
+  jira issue assign $issue "Team Member"
+done
+```
+
+### Keyboard Shortcuts in Interactive Mode
+
+Master the interactive UI for speed:
+- Use **j/k** instead of arrows for Vim-like navigation
+- Press **v** to quickly view details without leaving the list
+- Press **m** to transition without navigating to browser
+- Use **c** and **CTRL+k** to quickly copy links/keys for sharing
+
+### Output Formatting for Different Needs
+
+```bash
+# For spreadsheets
+jira issue list --csv > issues.csv
+
+# For scripts
+jira issue list --plain --no-headers --columns key
+
+# For reports
+jira issue list --plain --columns key,status,assignee,summary
+
+# For JSON processing
+jira issue list --raw | jq '.issues[] | {key, summary}'
+```