jira-read-ticket

bkircher 的头像作者 bkircher

当用户提及或引用Jira工单且您想提取描述、评论或更多信息时使用。

📖 中文导读:当用户提及或引用Jira工单且您想提取描述、评论或更多信息时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: jira-read-ticket description: Use whenever a user mentions or references a Jira ticket and you want to pull out description, comments, or more.

Jira data access instructions

Retrieve Jira issue data from Atlassian Cloud and return only the requested fields in JSON format.

Inputs

  • Jira issue key or ticket URL
  • Environment variables: ATLASSIAN_URL, ATLASSIAN_EMAIL, ATLASSIAN_API_TOKEN

Workflow

1) Verify environment variables

  • Ensure all required variables are set. Never output or log token values.
  • If missing, ask the user to set them before calling the API.

Variables: ATLASSIAN_URL, ATLASSIAN_EMAIL, ATLASSIAN_API_TOKEN

2) Identify the issue key

  • If the user provides a URL, parse the key (example: https://.../browse/ABC-123 -> ABC-123).
  • If the key is missing, ask the user for it.

3) Fetch data

Use these scripts before alternatives:

  • scripts/fetch_comments.py: Gets all ticket comments as JSON.
  • scripts/fetch_assigned_tickets.py: Gets assigned tickets (JSON array).
  • scripts/fetch_description.py: Gets description and details for one ticket (JSON).

Alternatively, use Jira REST API v3 with basic authentication, curl, and jq. Example for assigned tickets with JQL:

curl -s \
  -u "$ATLASSIAN_EMAIL:$ATLASSIAN_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  "$ATLASSIAN_URL/rest/api/3/search/jql" \
  --data '{
    "jql": "assignee = currentUser()",
    "fields": ["key", "summary", "status", "issuetype", "project"],
    "maxResults": 100
  }'
  • Use the fields parameter to limit payload when only specific fields are needed.

4) Extract results

  • Python scripts return JSON.
  • When using curl, use jq to extract fields of interest.

Notes

  • Jira may return rich text (Atlassian Document Format). Prefer renderedFields, fallback to fields.
  • Use /rest/api/3/search/jql for JQL POST requests. /rest/api/3/search is deprecated.
  • Retry API requests with increased permissions if network restrictions occur.
  • Never log or output secrets—reference environment variable names only.
  • Read-only operation: do not alter ticket data unless explicitly authorized by the user.