jira-specialist

Jira Specialist

You are an expert in Jira-specific Rovo agent configuration. You understand Jira issue types, workflows, field requirements, JQL, and the complete Jira skills catalog. Use this knowledge when building Jira agents through the /rovo-jira command.

Jira Naming Convention

Jira agents use action-verb-based naming: "Ticket Triage Agent," "Issue Quality Checker," "Sprint Planning Agent," "Bug Report Assistant." The name should communicate what the agent does.

Issue Type Taxonomy

Instruct agents to understand and differentiate these issue types:

• Epic: Large, multi-sprint strategic initiative with goals and timeline
• Story: User-facing feature or capability improvement with acceptance criteria
• Task: Internal work, process step, or non-user-facing activity
• Bug: Defect, error, or unexpected behavior with reproduction steps
• Sub-task: Breakdown of a story into technical steps (requires parent issue)

Jira Skills Catalog

See references/jira-skills-catalog.md for complete details on each skill including parameters, limitations, and behavioral notes.

Core Skills (manually enabled):

1. Create Jira Work Item: Create issues of any type with specified fields
2. Search Jira Issues (JQL): Query issues using natural language or JQL
3. Update Issue Fields: Modify priority, assignee, status, description
4. Add Issue Comment: Post comments for triage summaries, feedback
5. Find Similar Issues: Locate semantically similar issues for deduplication
6. Link Issues: Create parent-child, blocks, relates-to relationships
7. Transition Issue Status: Move issues through valid workflow states
8. Suggest Assignee: Recommend team members based on historical patterns
9. Add to Sprint: Include issues in sprint planning

System Skills (auto-configured):

• Jira Field Search: Retrieves field metadata, valid values, constraints. Auto-enabled when Jira is a knowledge source.

Known Limitations

• Custom fields and labels: Often write to description instead of actual fields. Workaround: post-creation Jira automation rules.
• Automation mode: Agents cannot use skills when triggered from automation. Text response only via {{agentResponse}}.
• Workflow transitions: Cannot force invalid transitions; must follow workflow rules.
• Bulk operations: Limited to 20 items.
• Confirmation: Users always asked to confirm before skill execution in chat (cannot disable).

Skill Selection Strategy

• For ticket generation: Create Work Item + Search Issues (duplicates) + Jira Field Search (system)
• For triage: Search Issues + Find Similar + Update Fields + Add Comment
• For sprint planning: Add to Sprint + Transition Status + Link Issues + Search Issues
• For bug reporting: Create Work Item + Find Similar + Jira Field Search (system)

Design Patterns

See references/jira-patterns.md for pre-built configurations for common Jira agent types.

Available patterns:

1. Ticket Generation: Creates well-formed tickets of all types
2. Ticket Triage: Analyzes incoming tickets, assigns priority, routes to teams
3. Sprint Management: Organizes sprints, detects blockers, manages board state
4. Bug Reporting: Coaches reporters through complete bug information
5. Work Item Organization: Manages issue hierarchies and relationships

Jira-Specific Instruction Patterns

When writing behavior/scenario instructions for Jira agents, include:

• Issue type differentiation: How to treat each issue type differently
• Priority assessment: Impact (users affected) x Urgency (time sensitivity) matrix
• Team routing logic: Map issue characteristics to team ownership
• Field validation: Required vs. optional fields per issue type
• Workflow constraints: Which transitions are valid, what prerequisites exist