triage-epic

Triage On Hold Jira doc tickets by checking upstream MDEV resolution and merged commits.

28|115|Updated Jan 28, 2025
One-click install
npx skills add https://github.com/mariadb-corporation/mariadb-docs --skill triage-epic-mariadb-corporation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: triage-epic
Source: https://github.com/mariadb-corporation/mariadb-docs/tree/main/.claude/skills/triage-epic
Command: npx skills add https://github.com/mariadb-corporation/mariadb-docs --skill triage-epic-mariadb-corporation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? MariaDB DOCS release epics accumulate auto-created child tickets parked in On Hold long after the upstream MDEV development work has shipped, and nothing moves them back automatically. This Skill sweeps those tickets, determines per ticket whether the upstream work is actually done, and releases the ready ones for writing. ## Core Features & Use Cases - Evidence-backed tiering: Resolves each ticket's primary MDEV, checks the public jira.mariadb.org status, resolution, and fix version, and inspects a local MariaDB source clone for merged or reverted commits, classifying tickets as READY, CANDIDATE, NOT READY, or AMBIGUOUS. - Dry-run by default: Prints a triage table and proposed comment briefs, then waits for explicit approval before posting a Jira comment and transitioning tickets from On Hold to TODO. - Revert and conflict detection: Flags reverted work, series mismatches, and negative human signals in MDEV comments so writers are never sent to document pulled features. - Use Case: Before planning a documentation sprint, ask which doc tickets in the 13.1 release epic are ready to write; the Skill reports which On Hold children have shipped upstream work and, with approval, promotes them to TODO. ## Quick Start Ask the assistant to triage DOCS-6084 and report which On Hold doc tickets are ready to write.

Frequently Asked Questions about triage-epic

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find which MariaDB doc tickets are ready to write?▼

Run the triage against the release epic, for example by asking to triage DOCS-6084. The Skill checks each On Hold child's MDEV resolution and numbered fix version on jira.mariadb.org, tiers the tickets, and promotes READY ones to TODO after your approval.

What makes a Jira doc ticket READY in this triage?▼

A ticket is READY only when its MDEV has a resolution like Fixed or Done and a numbered fix version such as 13.1.1 rather than the bare 13.1 placeholder, with no revert found. Merged code, green PRs, or an In Testing status alone only reach CANDIDATE.

Does the triage work without a local MariaDB source clone?▼

Yes, degraded mode is fully supported. READY tiering comes from Jira fields alone; the clone only adds revert detection and the commit SHAs quoted in the brief, and every brief notes when the revert check was skipped.

Can this Skill write or close documentation tickets?▼

No. It only posts a triage comment and transitions tickets from On Hold to TODO, and only after explicit approval. It never closes tickets, edits descriptions, writes documentation, or modifies the upstream MDEV or source clone.

Why does the triage not promote tickets with merged commits?▼

Merged code only proves the change exists, not that it shipped. Features can sit on preview branches for months and still be pulled from a release, so only the MDEV's resolution plus a numbered fix version promotes a ticket.