| name | automating-bug-reporting |
| description | Processes failed test executions, screenshots, and logs to generate comprehensive bug reports and automatically create JIRA tickets. Includes root cause analysis and environment details. |
Automating Bug Reporting
When to use this skill
- When a user provides a "Failed test execution" report, "Screenshot", or "Logs".
- When a bug report needs to be generated with "Steps to Reproduce", "Expected/Actual Results", and "Root Cause".
- When automatic JIRA ticket creation with "Priority" and "Severity" is required.
Workflow
- Artifact Analysis:
- Logs: Parse logs to identify the stack trace, error message, and timestamp.
- Screenshot: Analyze the screenshot to identify visual discrepancies or UI state at failure.
- Execution Report: Identify the specific test case that failed and the environment it ran in.
- Report Generation:
- Synthesize findings into a structured bug report.
- Determine Root Cause by correlating log errors with test steps.
- Assess Priority and Severity based on error type (e.g., Crash = Blocker/P0, Typos = Low/P3).
- JIRA Automation:
- Format the synthesized data for JIRA API.
- Execute the creation script or provide the JSON payload for manual entry if API is disconnected.
Instructions
1. Data Identification
- Tracebacks: Look for keywords like
AssertionError, NullPointerException, TimeoutError.
- Log Correlation: Match the failure timestamp in logs with the test step execution.
2. Bug Report Template
# [Bug Title]
- **Environment**: [OS, Browser, Version, Environment (Stage/Prod)]
- **Steps to Reproduce**:
1. ...
2. ...
- **Expected Result**: ...
- **Actual Result**: ...
- **Root Cause Analysis (RCA)**: [The technical reason why it failed]
- **Priority**: [Critical|High|Medium|Low]
- **Severity**: [S1|S2|S3|S4]
3. Automatic JIRA Creation
Use the provided script in scripts/jira_ticket_helper.py (if configured) or generate the command:
python scripts/jira_ticket_helper.py --title "[Title]" --description "[Body]" --priority "High"
Checklist
Resources
