quality-engineering-jira-integration - SKILL.md Agent Skill

name: quality-engineering-jira-integration description: "Jira ↔ Zephyr traceability: fetch story AC and components, detect existing TC links, link new Zephyr TCs back to Jira, and apply has-zephyr-tests labels. Use after creating Zephyr test cases that need linking, when fetching a Jira story's details for test generation, or when auditing and cleaning up stale TC links." metadata: triggers: keywords: - jira issue - zephyr link - has-zephyr-tests - traceability - link test case

Jira Integration Standards

Priority: P1 (HIGH)

1. Retrieving Issue Details

Fetch Core Info: Retrieve Summary, Description, Acceptance Criteria (AC), and Components.
Jira Key: ALWAYS reference issue by its unique Jira Ticket ID (e.g., TICK-123).
Sibling Analysis: Identify other Jira issues with same Component or Market Variants (VN/MY/SG) to find potentially impacted Zephyr TCs.
Identify Links: Use Get Issue Link Test Cases with Jira issue key to check for existing linked TCs before creating duplicates.
Actor Mapping: Extract reporter, assignee, and Story Points for context.

2. Linking Zephyr Test Cases

Traceability: After creating Zephyr Test Case, link it back to corresponding Jira Issue using Remote Link or Zephyr Issue Link.
Format: Use Zephyr Scale key (e.g., PROJ-T123) in Jira link or comment.
Labels: Apply has-zephyr-tests label to Jira issue once test cases successfully linked.

3. Jira-Zephyr Workflow

Fetch: Get Jira User Story details.
Generate: Create Zephyr Test Case using generation skill.
Link: Use SmartBear MCP tool Create Test Case Issue Link to bridge two.
Notify: Add comment to Jira: Linked Zephyr Test Case: {test_case_key}.

4. Best Practices

Concise Summaries: Keep Jira comments professional and brief.
Traceability Matrix: Ensure every AC in Jira at least one linked Zephyr Test Case.
Cleanup: Remove unused labels or outdated links during refactors.

5. Anti-Patterns

No Ghosting: Create tests then link to Jira (Traceability).
No Spam: Post single comment per link.
No Missing Labels: Update Jira labels after linking.