К основному содержанию
скилл CX Codex

jira-assistant — скилл для Claude Code: что делает и как установить

Скилл jira-assistant управляет задачами Jira через Atlassian MCP: находит тикеты, создаёт таски по шаблону, меняет статусы и оставляет комментарии прямо из чата Claude Code.

MIT ★ 7 191 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add tech-leads-club/agent-skills --skill jira-assistant -a claude-code
Открыть на GitHub

Что делает jira-assistant

Скилл взаимодействует с Jira через инструменты Atlassian MCP. Он умеет искать задачи простыми фразами через Rovo Search либо точными JQL-запросами, где обязательно подставляет ключ проекта. При создании новых тикетов агент сначала запрашивает метаданные полей, а затем заполняет описание по структурированному шаблону: с контекстом, техническими требованиями, критериями приёмки и оценкой.

Настройки рабочего пространства ассистент ищет в файле .cursor/rules/jira-config.mdc. Если файла нет, скилл запрашивает доступные проекты через MCP или просит указать ключ проекта напрямую. Без подключённых инструментов Atlassian MCP команды выполняться не будут, а для взаимодействия со страницами Confluence этот скилл не подходит — для этого автор рекомендует confluence-assistant.

Какие задачи решает

  • искать задачи в Jira простым текстом или через фильтры JQL
  • заводить таски, эпики и подзадачи по готовому шаблону
  • переводить тикеты по этапам воркфлоу от To Do до Done
  • обновлять поля и добавлять комментарии к существующим тикетам

Примеры запросов агенту

  • Создай таску на внедрение аутентификации через JWT в проекте DEV
  • Найди мои задачи в статусе In Progress и покажи их детали
  • Переведи задачу KAN-123 в статус Done и добавь комментарий о завершении

Как установить jira-assistant

1Через Skills CLI (Vercel)

npx skills add tech-leads-club/agent-skills --skill jira-assistant -a claude-code

2Вручную: положить файлы

~/.claude/skills/jira-assistant/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/jira-assistant/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о jira-assistant

Как установить jira-assistant в Claude Code?

Выполните команду npx skills add tech-leads-club/agent-skills --skill jira-assistant -a claude-code. Также можно вручную поместить файл по пути ~/.claude/skills/jira-assistant/SKILL.md.

Что нужно для работы скилла jira-assistant?

Требуется настроенный сервер Atlassian MCP с доступом к инструментам Jira. Параметры проекта можно сохранить заранее в .cursor/rules/jira-config.mdc, указав Project Key и Cloud ID.

Подходит ли скилл для работы со страницами Confluence?

Нет, скилл работает только с задачами Jira. Для статей и пространств Confluence автор подготовил отдельный скилл confluence-assistant.

Исходный текст

SKILL.md · MIT
---
description: Manage Jira issues via Atlassian MCP — search, create, update, transition status, and handle sprint tasks. Auto-detects workspace configuration. Use when user says "create a Jira ticket", "update my sprint", "check Jira status", "transition this issue", "search Jira", or "move ticket to done". Do NOT use for Confluence pages (use confluence-assistant).
name: jira-assistant
---

# Jira Assistant

You are an expert in using Atlassian MCP tools to interact with Jira.

## When to Use

Use this skill when the user asks to:

- Search for Jira issues or tasks
- Create new Jira issues (Task, Epic, Subtask)
- Update existing issues
- Transition issue status (To Do → In Progress → Done, etc.)
- Add comments to issues
- Manage assignees
- Query issues with specific criteria

## Configuration

**Project Detection Strategy (Automatic):**

1. **Check workspace rules first**: Look for Jira configuration in `.cursor/rules/jira-config.mdc`
2. **If not found**: Use MCP search tools to discover available projects
3. **If still unclear**: Ask user to specify project key
4. **Use detected values** for all Jira operations in this conversation

### Configuration Detection Workflow

When you activate this skill:

1. Check if workspace has `.cursor/rules/jira-config.mdc` with Jira configuration
2. If found, extract and use: Project Key, Cloud ID, URL, Board URL
3. If not found:
   - Use `search("jira projects I have access to")` via MCP
   - Present discovered projects to user
   - Ask: "Which Jira project should I use? (e.g., KAN, PROJ, DEV)"
4. Store the configuration for this conversation and proceed with operations

**Note for skill users:** To configure this skill for your workspace, create `.cursor/rules/jira-config.mdc` with your project details.

## Workflow

### 1. Finding Issues (Always Start Here)

**Use `search` (Rovo Search) first** for general queries:

```
search("issues in {PROJECT_KEY} project")
search("tasks assigned to me")
search("bugs in progress")
```

- Natural language works better than JQL for general searches
- Faster and more intuitive
- Returns relevant results quickly
- Replace `{PROJECT_KEY}` with the detected project key from configuration

### 2. Searching with Specific Criteria

**Use `searchJiraIssuesUsingJql`** when you need precise filters:

**⚠️ ALWAYS include `project = {PROJECT_KEY}` in JQL queries**

Examples (replace `{PROJECT_KEY}` with detected project key):

```
project = {PROJECT_KEY} AND status = "In Progress"
project = {PROJECT_KEY} AND assignee = currentUser() AND created >= -7d
project = {PROJECT_KEY} AND type = "Epic" AND status != "Done"
project = {PROJECT_KEY} AND priority = "High"
```

### 3. Getting Issue Details

Depending on what you have:

- **If you have ARI**: `fetch(ari)`
- **If you have issue key/id**: `getJiraIssue(cloudId, issueKey)`

### 4. Creating Issues

**ALWAYS use the detected `projectKey` and `cloudId` from configuration**

#### Step-by-step process:

```
a. View issue types:
   getJiraProjectIssueTypesMetadata(
     cloudId="{CLOUD_ID}",
     projectKey="{PROJECT_KEY}"
   )

b. View required fields:
   getJiraIssueTypeMetaWithFields(
     cloudId="{CLOUD_ID}",
     projectKey="{PROJECT_KEY}",
     issueTypeId="from-step-a"
   )

c. Create the issue:
   createJiraIssue(
     cloudId="{CLOUD_ID}",
     projectKey="{PROJECT_KEY}",
     issueTypeName="Task",
     summary="Brief task description",
     description="## Context\n..."
   )
```

**Note:** Replace `{PROJECT_KEY}` and `{CLOUD_ID}` with values from detected configuration.

**Available issue types:**

- Task (default)
- Epic
- Subtask (requires `parent` field with parent issue key)

### 5. Updating and Transitioning Issues

#### Edit fields:

```
editJiraIssue(cloudId, issueKey, fields)
```

#### Change status:

```
1. Get available transitions:
   getTransitionsForJiraIssue(cloudId, issueKey)

2. Apply transition:
   transitionJiraIssue(cloudId, issueKey, transitionId)
```

#### Add comment:

```
addCommentToJiraIssue(cloudId, issueKey, comment)
```

## Default Task Template

**ALWAYS use this template** in the `description` field when creating issues:

```markdown
## Context

[Brief explanation of the problem or need]

## Objective

[What needs to be accomplished]

## Technical Requirements

[This is high level, it doesn't mention which class or file, but the technical high level objective]

- [ ] Requirement 1
- [ ] Requirement 2
- [ ] Requirement 3

## Acceptance Criteria

- [ ] Criteria 1
- [ ] Criteria 2
- [ ] Criteria 3

## Technical Notes

[Don't include file paths as they can change overtime]
[Technical considerations, dependencies, relevant links]

## Estimate

[Time estimate or story points, if applicable]
```

## Best Practices

### ✅ DO

- **Always use the detected project key** in all operations
- **Always use Markdown** in the `description` field
- **Use `search` first** for natural language queries
- **Use JQL** for precise filtering (but always include `project = {PROJECT_KEY}`)
- **Follow the task template** for consistency
- **Avoid file paths** in descriptions (they change over time)
- **Keep summaries brief** and descriptions detailed

### ⚠️ IMPORTANT

- **Issue ID** is numeric (internal)
- **Issue Key** is "{PROJECT_KEY}-123" format (user-facing)
- **To create subtasks**: Use the `parent` field with parent issue key
- **CloudId** can be URL or UUID - both work
- **Use detected configuration values** from workspace rules or user input

## Examples

### Example 1: Create a Task

```
User: "Create a task to implement user authentication"

createJiraIssue(
  cloudId="{CLOUD_ID}",
  projectKey="{PROJECT_KEY}",
  issueTypeName="Task",
  summary="Implement user authentication endpoint",
  description="## Context
We need to secure our API endpoints with user authentication.

## Objective
Implement JWT-based authentication for API access.

## Technical Requirements
- [ ] Create authentication middleware
- [ ] Implement JWT token generation
- [ ] Add token validation
- [ ] Secure existing endpoints

## Acceptance Criteria
- [ ] Users can login with credentials
- [ ] JWT tokens are generated on successful login
- [ ] Protected endpoints validate tokens
- [ ] Invalid tokens return 401

## Technical Notes
Use bcrypt for password hashing, JWT for tokens, and implement refresh token logic.

## Estimate
5 story points"
)
```

**Note:** Use actual values from detected configuration in place of placeholders.

### Example 2: Search and Update Issue

```
User: "Find my in-progress tasks and update the first one"

1. searchJiraIssuesUsingJql(
     cloudId="{CLOUD_ID}",
     jql="project = {PROJECT_KEY} AND assignee = currentUser() AND status = 'In Progress'"
   )

2. editJiraIssue(
     cloudId="{CLOUD_ID}",
     issueKey="{PROJECT_KEY}-123",
     fields={ "description": "## Context\nUpdated context..." }
   )
```

**Note:** Replace placeholders with detected configuration values.

### Example 3: Transition Issue Status

```
User: "Move task {PROJECT_KEY}-456 to Done"

1. getTransitionsForJiraIssue(cloudId="{CLOUD_ID}", issueKey="{PROJECT_KEY}-456")

2. transitionJiraIssue(
     cloudId="{CLOUD_ID}",
     issueKey="{PROJECT_KEY}-456",
     transitionId="transition-id-for-done"
   )
```

**Note:** Replace placeholders with detected configuration values.

### Example 4: Create Subtask

```
User: "Create a subtask for {PROJECT_KEY}-789"

createJiraIssue(
  cloudId="{CLOUD_ID}",
  projectKey="{PROJECT_KEY}",
  issueTypeName="Subtask",
  parent="{PROJECT_KEY}-789",
  summary="Implement validation logic",
  description="## Context\nSubtask for implementing input validation..."
)
```

**Note:** Replace placeholders with detected configuration values.

## Common JQL Patterns

All queries **MUST** include `project = {PROJECT_KEY}` (use detected project key):

```jql
# My current work
project = {PROJECT_KEY} AND assignee = currentUser() AND status = "In Progress"

# Recent issues
project = {PROJECT_KEY} AND created >= -7d

# High priority bugs
project = {PROJECT_KEY} AND type = Bug AND priority = High

# Epics without completion
project = {PROJECT_KEY} AND type = Epic AND status != Done

# Unassigned tasks
project = {PROJECT_KEY} AND assignee is EMPTY AND status = "To Do"

# Issues updated this week
project = {PROJECT_KEY} AND updated >= startOfWeek()
```

**Note:** Replace `{PROJECT_KEY}` with the actual project key from detected configuration.

## Important Notes

- **Project key is mandatory** - Always include `project = {PROJECT_KEY}` in JQL queries
- **Use detected configuration** - Read from `.cursor/rules/jira-config.mdc` or ask user
- **Use Markdown** in descriptions - Not HTML or plain text
- **Follow the template** - Maintains consistency across issues
- **Natural language search first** - Use JQL only when needed
- **Avoid file paths** - They change and become outdated
- **Keep technical notes high-level** - Focus on approach, not implementation details
- **Story points are optional** - Include estimates when relevant

© tech-leads-club · MIT · tech-leads-club/agent-skills

Похожие скиллы

Все скиллы по теме «Заметки, задачи и проекты» →
jira odyssey4me Работает с задачами Jira через JQL: ищет, создаёт и обновляет тикеты, читает комментарии. Запускается скриптом jira.py, которому нужен доступ к API вашего инстанса. CX Codex +1 139установок atlassian-jira magurelabs MCP-сервер atlassian-jira для Claude Code и Cursor связывает агента с Jira API. Находит задачи, регистрирует списания времени, прикрепляет файлы и переводит статусы тикетов. CX Codex +1 ★ 10звёзд репо atlassian-mcp https://github.com/Jeffallan Скилл atlassian-mcp для работы с Jira и Confluence через MCP-серверы: запросы на JQL и CQL, создание тикетов, спринты, поиск страниц. CX Codex +1 4 800установок atlassian-templates Alireza Rezvani Скилл atlassian-templates для Claude Code, который создаёт и правит шаблоны Jira и Confluence. Берёт на себя структуру страниц, макросы и стандартные блоки, чтобы контент в команде выглядел одинаково. CX Codex +1 680установок search-company-knowledge atlassian Скилл search-company-knowledge ищет информацию о процессах и системах одновременно в Confluence и Jira. Скилл пригодится, когда агенту нужно собрать факты из документации и тикетов со ссылками на источники. CX Codex +1 505установок atlassian sanjay3290 Скилл atlassian для Claude Code управляет задачами Jira и страницами Confluence из агента. Ищет тикеты через JQL, читает документацию и меняет статусы. CX Codex +1 329установок

Из того же набора130

Весь набор →
shopify-developer Скилл shopify-developer для Claude Code даёт агенту справочник по Liquid, темам OS 2.0, GraphQL API, Functions и Hydrogen для разработки под Shopify. CX Codex +1 ★ 7 191звёзд репо aws-advisor Скилл aws-advisor консультирует по архитектуре AWS, проверяет безопасность и сверяет параметры сервисов с документацией через MCP-инструменты. CX Codex +1 ★ 7 191звёзд репо rails-dev Скилл rails-dev для Claude Code задаёт конвенции Ruby on Rails: богатые модели, состояния-записи, Minitest с фикстурами и минимум внешних гемов. CX Codex +1 ★ 7 191звёзд репо demo Скилл demo для Claude Code записывает проход по веб-приложению в MP4 на настоящем рабочем столе и сохраняет телеметрию кликов и прокрутки. Запись демо для чейнджлога и документации. CX Codex +1 ★ 7 191звёзд репо tlc-implement Скилл tlc-implement доводит план из tlc-plan или небольшой тикет до рабочего кода через замороженные проверки, сборку и независимую верификацию. CX Codex +1 ★ 7 191звёзд репо tlc-generative-engine-optimization Скилл tlc-generative-engine-optimization готовит веб-страницы к цитированию в ChatGPT, Perplexity и Google AI Overviews. Настраивает семантическую разметку, Schema.org и файл llms.txt. CX Codex +1 ★ 7 191звёзд репо tlc-spec-lean Скилл tlc-spec-lean для Claude Code ведёт разработку функции от плана и проверяемых критериев до сборки и независимой проверки. Помогает подтвердить требования до начала работы. CX Codex +1 ★ 7 191звёзд репо create-rfc Скилл create-rfc для Claude Code. Собирает RFC по разделам: контекст, критерии решения, варианты, итог. Фиксирует направление до начала работы. CX Codex +1 ★ 7 191звёзд репо

Ещё в каталоге

DevPlan MCP Server mmorris35 MCP-сервер DevPlan MCP Server для Claude Code и других ИИ-ассистентов: превращает задумку в пошаговый план с фазами и проверками. Решает потерю контекста между сессиями и пропуски шагов. CX Codex +1 ★ 7звёзд репо Amazing Marvin (complete) andreasd083 Amazing Marvin (complete) — MCP-сервер для Claude Code, связывающий планировщик с ассистентом через 50 инструментов. Из чата можно вести задачи, привычки и учёт времени. CX Codex +1 ★ 11звёзд репо Tedix tedix-hq Tedix связывает ИИ-ассистентов с общей очередью задач, контекстом команды и записями о выполненной работе. Решения, требующие одобрения человека, попадают в отдельную очередь. CX Codex +1 ★ 43звёзд репо flow-next Gordon Mickel Скилл flow-next для Claude Code управляет задачами и спецификациями в .flow/: показывает списки и статусы, создаёт задачи и закрывает выполненные. Помогает разобраться, что запланировано и готово к работе. CX Codex +1 ★ 730звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой