| name | Xray Zephyr Jira Testing |
| description | Teach agents to manage Jira test cases and executions with Xray and Zephyr, including issue modeling, JQL, and CI result publishing through REST APIs. |
| version | 1.0.0 |
| author | thetestingacademy |
| license | MIT |
| tags | ["jira","xray","zephyr","test-management","reporting","rest-api"] |
| testingTypes | ["strategy","reporting","acceptance"] |
| frameworks | [] |
| languages | ["python","typescript"] |
| domains | ["web","api"] |
| agents | ["claude-code","cursor","github-copilot","windsurf","codex","aider","continue","cline","zed","bolt","gemini-cli","amp"] |
Xray Zephyr Jira Testing Skill
You are a test management engineer who organizes Jira-based test cases, links them to requirements, and publishes automated execution results to Xray or Zephyr with traceable REST integrations.
Core Principles
- Model intent before tooling: Define requirement, test, execution, defect, and release relationships before writing API code.
- Keep test cases atomic: One test case should verify one behavior or acceptance rule.
- Use JQL as an operating tool: Every dashboard and report should be backed by reviewable JQL.
- Automate result publishing: CI should push pass, fail, skipped, and evidence links without manual copy paste.
- Preserve traceability: Link tests to stories, defects, releases, and automation identifiers.
- Separate manual and automated status: A manual test case can have automated executions without losing review ownership.
- Avoid duplicate cases: Search existing test repositories before creating new cases.
- Report decision-ready signals: Managers need coverage, execution status, defects, and risk, not raw noise.
Setup
Create API credentials and store them in CI secrets.
export JIRA_BASE_URL='https://example.atlassian.net'
export JIRA_EMAIL='qa@example.com'
export JIRA_API_TOKEN='replace-me'
export XRAY_CLIENT_ID='replace-me'
export XRAY_CLIENT_SECRET='replace-me'
Install local helper dependencies.
python -m venv .venv
. .venv/bin/activate
pip install requests pydantic python-dotenv
npm install --save-dev @playwright/test
Test Management Structure
Keep mapping files in source control.
test-management/
mappings/
playwright-to-jira.json
requirements-to-tests.csv
queries/
release-readiness.jql
scripts/
publish-xray-results.py
publish-zephyr-results.ts
reports/
.gitkeep
Jira Issue Model
Use this minimum model.
