Agent skill

jira

Manages Jira issues including creation, listing, transitions, and workflow integration.

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/goffity/claude-km-skill/tree/main/skills/jira

SKILL.md

Jira Integration

จัดการ Jira issues ผ่าน CLI รองรับ Atlassian Cloud

Usage

/jira [command] [arguments]

Available Commands

Command Description
/jira init ตั้งค่า Jira credentials
/jira test ทดสอบ connection
/jira list แสดง issues ใน project
/jira my แสดง issues ที่ assign ให้ฉัน
/jira get <key> ดู issue details
/jira create สร้าง issue ใหม่
/jira create-story สร้าง Story พร้อม template
/jira create-epic สร้าง Epic พร้อม template
/jira create-subtask-templated สร้าง Subtask พร้อม template และ dependency links
/jira search <query> ค้นหา issues
/jira transitions <key> ดู transitions ที่ทำได้
/jira transition <key> <id> เปลี่ยน status ด้วย transition ID
/jira comment <key> เพิ่ม comment
/jira add-labels <key> เพิ่ม labels
/jira link <type> สร้าง dependency link

Instructions

Command: init

ตั้งค่า Jira credentials

bash
./scripts/jira-client.sh init

หลังจาก init สำเร็จ:

Jira configured successfully!

ใช้ /jira test เพื่อทดสอบ connection

Command: test

ทดสอบ connection กับ Jira

bash
./scripts/jira-client.sh test

Output:

Testing connection to [domain]...
Connected as: [name] ([email])

Command: list

แสดง issues ใน project

bash
# Default project
./scripts/jira-client.sh list

# Specific project
./scripts/jira-client.sh list PROJ

# Filter by status
./scripts/jira-client.sh list PROJ "In Progress"

แสดงผลในรูปแบบ table:

KEY        STATUS       SUMMARY
PROJ-123   To Do        Fix login bug
PROJ-124   In Progress  Add search feature
PROJ-125   Done         Update docs

Command: my

แสดง issues ที่ assign ให้ user

bash
./scripts/jira-client.sh my-issues

# Filter by status
./scripts/jira-client.sh my-issues "To Do"

Command: get

ดู issue details

bash
./scripts/jira-client.sh get PROJ-123

แสดงผล:

json
{
  "key": "PROJ-123",
  "summary": "Fix login bug",
  "status": "In Progress",
  "type": "Bug",
  "priority": "High",
  "assignee": "John Doe",
  "url": "https://company.atlassian.net/browse/PROJ-123"
}

Command: create

สร้าง Jira issue ใหม่ (interactive)

Step 1: ถามข้อมูล issue

ใช้ AskUserQuestion:

สร้าง Jira Issue

1. Project Key (e.g., PROJ)
2. Issue Type (Task, Bug, Story, Epic)
3. Summary (หัวข้อ)
4. Description (รายละเอียด)
5. Priority (Highest, High, Medium, Low, Lowest)

Step 2: สร้าง issue

bash
./scripts/jira-client.sh create "[PROJECT]" "[SUMMARY]" "[DESCRIPTION]" "[TYPE]"

Step 3: แสดงผล

Issue Created!

Key: PROJ-123
URL: https://company.atlassian.net/browse/PROJ-123
Summary: [summary]
Type: [type]

ใช้ /focus แล้วเลือก "Jira (existing)" เพื่อเริ่มทำงาน

Command: create-story

สร้าง Story พร้อม standard template

bash
./scripts/jira-client.sh create-story PROJ "Feature summary" --labels Backend,Player --due 2026-02-14

Template Sections:

  • Overview - อธิบายสั้นๆ ว่าทำอะไร
  • Requirements - รายละเอียดความต้องการ
  • System Flow - flow diagram (ASCII art)
  • Subtask Dependencies - dependency tree
  • Acceptance Criteria - functional, admin, logging requirements
  • Definition of Done (DoD) - checklist
  • Test Scenarios - test cases สำหรับ QA

Options:

  • --labels L1,L2 - เพิ่ม labels (comma-separated)
  • --due YYYY-MM-DD - กำหนด due date

Command: create-epic

สร้าง Epic พร้อม standard template (same as Story)

bash
./scripts/jira-client.sh create-epic PROJ "Epic summary" --labels Backend --due 2026-02-28

Command: create-subtask-templated

สร้าง Subtask พร้อม template และ dependency links

bash
./scripts/jira-client.sh create-subtask-templated PROJ-123 "Phase 1: Data Models" \
  --labels Backend,Player \
  --due 2026-02-10 \
  --blocked-by PROJ-120 \
  --blocks PROJ-125,PROJ-128

Template Sections:

  • Scope - อธิบายว่า subtask นี้ทำอะไร
  • Dependencies - Blocked by / Blocks (links)
  • Tasks - รายละเอียดงาน พร้อม file locations และ code snippets
  • Acceptance Criteria - checklist

Options:

  • --labels L1,L2 - เพิ่ม labels
  • --due YYYY-MM-DD - กำหนด due date
  • --blocked-by KEY1,KEY2 - สร้าง "blocked by" links
  • --blocks KEY1,KEY2 - สร้าง "blocks" links

Command: add-labels

เพิ่ม labels ให้ issue

bash
./scripts/jira-client.sh add-labels PROJ-123 Backend Player game

Command: link

สร้าง dependency link ระหว่าง issues

bash
# PROJ-124 blocks PROJ-125
./scripts/jira-client.sh link blocks PROJ-124 PROJ-125

# PROJ-125 is blocked by PROJ-124
./scripts/jira-client.sh link blocked-by PROJ-125 PROJ-124

# PROJ-123 relates to PROJ-456
./scripts/jira-client.sh link relates PROJ-123 PROJ-456

Link Types:

  • blocks - from_key blocks to_key
  • blocked-by - from_key is blocked by to_key
  • relates - from_key relates to to_key

Workflow: Start Working on Issue

Note: ไม่มีคำสั่ง /jira start โดยตรง ให้ใช้ /focus แล้วเลือก "Jira (existing)" แทน หรือทำ workflow ด้านล่างนี้ด้วยตัวเอง

เริ่มทำงาน Jira issue - ดึงมาเป็น current focus

Step 1: ดึงข้อมูล issue

bash
./scripts/jira-client.sh get [ISSUE_KEY]

Step 2: สร้าง feature branch

bash
# Format: [type]/[issue-key]-[short-description]
# Type mapping from Jira issue type:
#   Bug -> fix
#   Story/Task -> feat
#   Epic -> feat
#   Improvement -> refactor

git checkout -b [type]/[ISSUE_KEY]-[slug]

Step 3: Update docs/current.md

bash
export TZ='Asia/Bangkok'
cat > docs/current.md << EOF
STATE: working
TASK: [ISSUE_KEY] - [summary]
SINCE: $(date '+%Y-%m-%d %H:%M')
ISSUE: [ISSUE_KEY]
BRANCH: [branch-name]
JIRA_URL: [url]
EOF

Step 4: Update activity.log

bash
export TZ='Asia/Bangkok'
echo "$(date '+%Y-%m-%d %H:%M') | working | [ISSUE_KEY] - [summary]" >> docs/logs/activity.log

Step 5: Transition issue to "In Progress" (if available)

bash
# Get available transitions
./scripts/jira-client.sh transitions [ISSUE_KEY]

# If "In Progress" or similar transition exists, apply it
./scripts/jira-client.sh transition [ISSUE_KEY] [transition_id]

Step 6: Assign to self

bash
./scripts/jira-client.sh assign [ISSUE_KEY] me

Output:

Started: [ISSUE_KEY]
Summary: [summary]
Branch: [branch]

Issue transitioned to: In Progress
Assigned to: you

Ready to work!

Command: transition

เปลี่ยน status ของ issue ผ่าน Jira workflow transitions

Step 1: แสดง available transitions

bash
./scripts/jira-client.sh transitions [ISSUE_KEY]

Step 2: ถามว่าจะเปลี่ยนเป็น status ไหน

ใช้ AskUserQuestion กับ options จาก transitions

Step 3: Apply transition

bash
./scripts/jira-client.sh transition [ISSUE_KEY] [transition_id]

Note: Jira ใช้ workflow transitions แทนการเปลี่ยน status โดยตรง ต้องใช้ transition ID (ตัวเลข) ไม่ใช่ชื่อ status

Command: comment

เพิ่ม comment ใน issue

Step 1: ถาม comment

ใส่ comment สำหรับ [ISSUE_KEY]:

Step 2: Add comment

bash
./scripts/jira-client.sh comment [ISSUE_KEY] "[comment]"

Configuration

First-time Setup

  1. ไปที่ https://id.atlassian.com/manage-profile/security/api-tokens
  2. สร้าง API Token
  3. รัน /jira init

Config File Locations

Type Location Priority
Project .jira-config 1 (highest)
User ~/.config/claude-km/jira.conf 2
Environment JIRA_* variables 3

Required Variables

bash
JIRA_DOMAIN="company.atlassian.net"
JIRA_EMAIL="user@example.com"
JIRA_API_TOKEN="your-api-token"
JIRA_PROJECT="PROJ"  # default project

Issue Type Mapping

Jira Type Git Branch Prefix
Bug fix/
Task feat/
Story feat/
Epic feat/
Improvement refactor/
Sub-task feat/

Examples

bash
# Setup
/jira init
/jira test

# Browse issues
/jira list PROJ
/jira my
/jira get PROJ-123

# Create issue
/jira create

# Create Story/Epic with templates
./scripts/jira-client.sh create-story PROJ "Feature summary" --labels Backend,Player --due 2026-02-14
./scripts/jira-client.sh create-epic PROJ "Big Feature Initiative" --labels Backend

# Create subtasks with dependencies
./scripts/jira-client.sh create-subtask-templated PROJ-123 "Phase 1: Data Models" --labels Backend --blocks PROJ-125,PROJ-128
./scripts/jira-client.sh create-subtask-templated PROJ-123 "Phase 2: Win Processing" --labels Backend --blocked-by PROJ-124 --blocks PROJ-126

# Add labels and links
./scripts/jira-client.sh add-labels PROJ-123 Backend Player game
./scripts/jira-client.sh link blocks PROJ-124 PROJ-125

# Start work (use /focus with Jira path)
/focus  # then select "Jira (existing)" and enter PROJ-123

# Change status (use transition ID from /jira transitions)
/jira transitions PROJ-123  # see available transitions
/jira transition PROJ-123 31  # 31 = Done (example ID)
/jira comment PROJ-123 "Fixed the issue"

Integration with Other Commands

Command Jira Integration
/focus เลือกได้ว่าจะสร้าง GitHub Issue หรือ Jira
/td อัพเดต Jira status เมื่อจบ session
/recap แสดง Jira issue ถ้ามี

Error Handling

Connection Error:

Error: Failed to connect to Jira
Check your credentials with: /jira init

Permission Error:

Error: Permission denied for [ISSUE_KEY]
You may not have access to this project

Invalid Issue:

Error: Issue not found: [ISSUE_KEY]
Check the issue key and try again

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

goffity/claude-km-skill

commit

Creates atomic commits by invoking TDG and commenting on related GitHub issues.

0 0
Explore
goffity/claude-km-skill

distill

Synthesizes related learnings into reusable knowledge base patterns.

0 0
Explore
goffity/claude-km-skill

security-auditor

Audits code for security vulnerabilities including OWASP Top 10 and authentication issues.

0 0
Explore
goffity/claude-km-skill

code-reviewer

Reviews code changes for bugs, security vulnerabilities, and performance issues.

0 0
Explore
goffity/claude-km-skill

example

Saves reusable code examples to the examples library with metadata and tags.

0 0
Explore
goffity/claude-km-skill

flow

Documents workflow diagrams and process flows with Mermaid diagram support.

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results