@deimoscloud/coreai 0.1.19 → 0.1.20

package/skills/jira/jira-transition/SKILL.md

@@ -0,0 +1,185 @@
+---
+description: Use when updating a Jira ticket status, moving a ticket to a different state, marking a ticket as done, starting work on a ticket, or putting a ticket in review. Handles status transitions with proper comments.
+argument-hint: TICKET-XX to <status>
+requires: [jira]
+---
+
+# Jira Ticket Transition
+
+You are transitioning: **$ARGUMENTS**
+
+## Valid Status Transitions
+
+```
+Backlog → To Do → In Progress → In Review → Done
+                ↓
+              Blocked
+                ↓
+            In Progress
+```
+
+| From | To | When |
+|------|-----|------|
+| Backlog | To Do | Sprint planning, ticket prioritized |
+| To Do | In Progress | Work begins on ticket |
+| In Progress | In Review | PR created |
+| In Progress | Blocked | Dependency or blocker identified |
+| Blocked | In Progress | Blocker resolved |
+| In Review | In Progress | PR feedback requires changes |
+| In Review | Done | PR merged, work complete |
+
+## Transition via Atlassian MCP
+
+### Get Current Status First
+
+```
+mcp__atlassian__getJiraIssue
+Issue Key: {{JIRA_PROJECT}}-XX
+```
+
+### Transition Ticket
+
+```
+mcp__atlassian__transitionJiraIssue
+Issue Key: {{JIRA_PROJECT}}-XX
+Transition: <target status>
+```
+
+### Add Transition Comment
+
+```
+mcp__atlassian__addCommentToJiraIssue
+Issue Key: {{JIRA_PROJECT}}-XX
+Comment: <transition comment>
+```
+
+## Required Comments by Transition
+
+### To Do → In Progress
+
+```
+Starting work on this ticket.
+Assigned to: @[agent-name]
+Branch: feature/{{JIRA_PROJECT}}-XX-[description]
+```
+
+### In Progress → In Review
+
+```
+PR created: <PR URL>
+
+Changes implemented:
+- [Change 1]
+- [Change 2]
+
+Ready for code review.
+```
+
+### In Progress → Blocked
+
+```
+BLOCKED: [Reason for block]
+
+Blocking issue: [Description or ticket reference]
+Required to unblock: [What needs to happen]
+```
+
+### Blocked → In Progress
+
+```
+Blocker resolved: [How it was resolved]
+Resuming work.
+```
+
+### In Review → In Progress
+
+```
+Addressing review feedback:
+- [Feedback item 1]
+- [Feedback item 2]
+
+Will update PR when changes are complete.
+```
+
+### In Review → Done
+
+```
+PR merged: [Merge commit SHA or PR URL]
+
+Acceptance criteria verified:
+- [x] [Criterion 1]
+- [x] [Criterion 2]
+
+Ticket complete.
+```
+
+## Workflow Integration
+
+This skill integrates with the workflow defined in `WORKFLOWS.md`:
+
+| Workflow State | Jira Status |
+|----------------|-------------|
+| BACKLOG | Backlog |
+| ASSIGNED | In Progress |
+| BRANCH_CREATED | In Progress |
+| IMPLEMENTING | In Progress |
+| PR_CREATED | In Review |
+| IN_REVIEW | In Review |
+| APPROVED | In Review |
+| MERGED | Done |
+| VERIFIED | Done |
+| DONE | Done |
+
+## Validation
+
+Before transitioning, verify:
+
+### To "In Progress"
+- [ ] Ticket has clear acceptance criteria
+- [ ] No blocking dependencies
+- [ ] Agent is ready to begin work
+
+### To "In Review"
+- [ ] PR exists and is linked
+- [ ] All commits pushed
+- [ ] CI checks passing (or will pass)
+
+### To "Done"
+- [ ] PR is merged
+- [ ] Acceptance criteria met
+- [ ] No open review comments
+
+### To "Blocked"
+- [ ] Blocker is clearly documented
+- [ ] Blocking ticket/issue referenced if applicable
+
+## Error Handling
+
+**If transition fails:**
+1. Check current ticket status
+2. Verify the transition is valid from current status
+3. Some transitions may require specific permissions
+
+**If MCP is unavailable:**
+Report to user:
+```
+Unable to transition ticket via MCP.
+Please manually update {{JIRA_PROJECT}}-XX to [status] in Jira.
+Add comment: [suggested comment]
+```
+
+## Completion
+
+After transition, report:
+```
+Jira Ticket Transitioned
+
+Ticket: {{JIRA_PROJECT}}-XX
+Previous Status: [old status]
+New Status: [new status]
+Comment Added: Yes
+
+URL: {{JIRA_URL}}/browse/{{JIRA_PROJECT}}-XX
+```
+
+Now proceed with the ticket transition.