Work on Ticket Skill

When to Use This Skill

Use this skill when:

• Starting work on a Jira ticket
• Creating a feature branch for a ticket
• Fetching ticket details and acceptance criteria
• Setting up workspace for new development work
• Users mention ticket IDs like "SAM1-123" or "work on ticket"

Prerequisites

1. Install Dependencies

cd .github/skills && npm install

2. Configure Jira Credentials

Create a .env file in your project root:

JIRA_URL=https://ihkreddy.atlassian.net
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token
JIRA_DEFAULT_PROJECT=SAM1

Workflow Process

1. Fetch Ticket Details

npx ts-node --esm .github/skills/skills/work-on-ticket/scripts/fetch-ticket.ts --ticket SAM1-123

This retrieves:

• Ticket summary and description
• Status and priority
• Assignee and reporter
• Acceptance criteria
• Labels

2. Start Working on a Ticket

npx ts-node --esm .github/skills/skills/work-on-ticket/scripts/start-work.ts --ticket SAM1-123

This will:

1. ✅ Fetch ticket details
2. ✅ Display summary and acceptance criteria
3. ✅ Create feature branch with proper naming
4. ✅ Transition ticket to "In Progress"
5. ✅ Add comment: "Started working on this ticket"

3. Branch Naming Conventions

• Feature: feature/sam1-123-short-description
• Bug fix: bugfix/sam1-123-short-description
• Hotfix: hotfix/sam1-123-short-description

Script Reference

fetch-ticket.ts

Retrieves complete ticket information from Jira.

# Basic fetch
npx ts-node --esm scripts/fetch-ticket.ts --ticket SAM1-123

# Output as JSON
npx ts-node --esm scripts/fetch-ticket.ts --ticket SAM1-123 --json

start-work.ts

Full workflow to start development.

# Start work with all defaults
npx ts-node --esm scripts/start-work.ts --ticket SAM1-123

# Skip branch creation
npx ts-node --esm scripts/start-work.ts --ticket SAM1-123 --no-branch

# Skip status transition
npx ts-node --esm scripts/start-work.ts --ticket SAM1-123 --no-transition

test-connection.ts

Verify Jira connectivity.

npx ts-node --esm scripts/test-connection.ts

Integration with create-ticket

After creating a ticket with create-ticket, use this skill to start development:

# First, create the ticket
npx ts-node --esm skills/create-ticket/scripts/create-ticket.ts \
  --summary "Add search filters" --type Story

# Output: Created ticket SAM1-15

# Then start working on it
npx ts-node --esm skills/work-on-ticket/scripts/start-work.ts --ticket SAM1-15