AgentSkillsCN

ticket-workflow

ScoreVision 的 Jira 工作流参考——工单状态、允许的流转路径,以及何时应将工单推进至下一阶段。

SKILL.md
--- frontmatter
name: ticket-workflow
description: ScoreVision's Jira workflow reference—ticket states, allowed transitions, and when to move tickets through the pipeline

ScoreVision Ticket Workflow

This document describes ScoreVision's Jira workflow states, transitions, and conventions.

Workflow States

StatusDescription
To DoWork not yet started
In ProgressActively being worked on
In DevelopmentCode is being written
On HoldBlocked or paused
In ReviewCode review in progress
Ready for QAAwaiting QA verification
DoneWork complete and verified

Status Categories

For JQL queries, statuses map to these categories:

  • To Do: statusCategory = 'To Do'
  • In Progress: statusCategory = 'In Progress' (includes In Development, In Review, Ready for QA, On Hold)
  • Done: statusCategory = Done

Valid Transitions

Current StatusScenarioTarget Status
To DoStarting workIn Progress
In ProgressCode being writtenIn Development
In ProgressWork completeIn Review
In ProgressWork complete, needs QAReady for QA
In ProgressBlockedOn Hold
In DevelopmentCode completeIn Review
In DevelopmentBlockedOn Hold
On HoldUnblockedIn Progress
In ReviewApprovedDone
In ReviewApproved, needs QAReady for QA
Ready for QAQA passedDone

Common JQL Patterns

sql
-- My open tickets
project = <PROJECT> AND assignee = currentUser() AND resolution = Unresolved

-- Tickets in active development
project = <PROJECT> AND status = 'In Development'

-- All in-progress work
project = <PROJECT> AND statusCategory = 'In Progress'

-- Ready for review
project = <PROJECT> AND status = 'In Review'

-- Current sprint
project = <PROJECT> AND Sprint = '<sprint-name>'

Ticket Review Categorization

When reviewing tickets against codebase state, categorize by:

  1. In Progress - Actively being worked on
  2. Blocked/On Hold - Waiting on external dependency or clarification
  3. To Do/Backlog - Ready to start
  4. In Review - Code review or QA in progress

Transition Triggers

TriggerAction
Work completeTransition to In Review or Ready for QA
Blocked by dependencyTransition to On Hold
Blocker resolvedTransition back to In Progress
Code merged and deployedTransition to Done