| name | jira-ticket |
| description | Prepare Jira create, comment, and safe-update payloads with safe dry-run fallback. Use with /jira-ticket when work tracking is requested. |
Jira Ticket
Use /jira-ticket when work tracking is requested.
When to use
- A plan or completed work needs a Jira ticket
- You need to comment on or update an existing ticket
- The user wants a ticket draft without actually creating it
Operations
Create
- Build from an approved plan or implementation slice (a plan file or markdown)
- Include: Summary, Description, Acceptance Criteria
- Render the payload with
omp jira render <plan-file> — this never writes to Jira. To create/comment/update, run omp jira apply <plan-file-or-ticket-key>, which defaults to dry-run and only writes when Jira is configured with JIRA_MODE=live, the user has explicitly confirmed, and the CLI has explicit body/field support for the operation you need.
Comment
- Add implementation evidence, verification results, or status updates
- Format for readability (use Jira wiki markup, not Markdown)
- Draft the comment payload and preview via dry-run only; do not run live comment writes from this skill until the CLI accepts an explicit comment body/body file.
Safe update
- Only update known simple fields (summary, description, labels)
- Draft update fields and preview via dry-run only; do not run live update writes from this skill until the CLI accepts explicit update fields.
- Do not guess transitions, issue links, project keys, or secrets
Rules
- Always preview with
omp jira render or omp jira apply … --dry-run (the default); live writes require explicit user confirmation plus CLI support for the exact payload being written
- If Jira config is missing, the commands stay in dry-run and print the payload — never fail silently
- Do not guess project keys, transitions, or credentials
- Keep acceptance criteria testable and specific
- Include file paths and evidence when commenting with implementation details
Output
Operation — create / comment / updateTarget — ticket key or "new"Payload — the Jira-formatted contentHuman action — what the user needs to do (e.g. "paste into Jira" if dry-run)
