ticket

Ticket Board — MCP Skill

Скилл для работы с системой тикетов через MCP-сервер ticket-board.

Инструменты MCP

Все инструменты имеют префикс mcp__ticket-board__:

Инструмент	Назначение
list_projects	Список проектов
list_crs	Список тикетов (с фильтрами)
get_cr	Получить тикет
create_cr	Создать тикет
update_cr_status	Изменить статус
update_cr_attrs	Изменить атрибуты (часы, приоритет, теги)
add_completion_notes	Добавить заметки о выполнении
manage_cr_sections	Работа с секциями контента

Статусы тикетов

Статус	Описание
Proposed	Предложен
Approved	Одобрен
In Progress	В работе
Implemented	Выполнен ✅
Rejected	Отклонён
On Hold	Приостановлен

Типы тикетов

Тип	Описание
Feature Enhancement	Улучшение / новая функция
Bug Fix	Исправление ошибки
Technical Debt	Технический долг
Architecture	Архитектура
Documentation	Документация
Content	Контент

Приоритеты

Приоритет	Описание
Critical	Критический
High	Высокий
Medium	Средний (по умолчанию)
Low	Низкий

---

Создание тикета

Для создания нового тикета используй create_cr:

{
  "project": "PROJECT_CODE",
  "type": "Feature Enhancement",
  "data": {
    "title": "Название задачи",
    "priority": "Medium"
  }
}

Если нужно добавить описание, используй поле content с Markdown-разметкой.

---

📝 Создание тикета для выполненной работы

Если задача УЖЕ выполнена — создай тикет сразу со всеми данными. Это экономит вызовы API и сохраняет полный контекст работы.

Вариант 1: Всё в одном вызове

{
  "project": "PROJECT_CODE",
  "type": "Bug Fix",
  "data": {
    "title": "Исправлена проблема X",
    "priority": "Medium",
    "status": "Implemented",
    "hours": 1.5,
    "content": "## 1. Описание\n\nОписание проблемы/задачи.\n\n## 2. Обоснование\n\nПочему это было нужно.\n\n## Выполнено\n\n### Что было сделано\n\n- Действие 1\n- Действие 2\n- Изменённые файлы\n\n### Результат\n\n- Итог работы"
  }
}

Вариант 2: Создать + заметки отдельно

Шаг 1 — создать тикет с часами:

{
  "project": "PROJECT_CODE",
  "type": "Feature Enhancement",
  "data": {
    "title": "Название",
    "status": "Implemented",
    "minutesAssessment": 10,
    "minutesDiagnosis": 20,
    "minutesImplementation": 60
  }
}

Шаг 2 — добавить заметки о выполнении:

{
  "cr_id": "CODE-XXX",
  "notes": "## Что было сделано\n\n- Действия\n\n## Результат\n\n- Итог"
}

В поле content обязательно включи секцию ## Выполнено с описанием выполненной работы.

---

🎯 Завершение тикета (ОБЯЗАТЕЛЬНО)

При переводе существующего тикета в Implemented выполни 3 шага строго в указанном порядке. Порядок важен, потому что после смены статуса на Implemented тикет считается закрытым и его сложнее редактировать.

Шаг 1: Часы работы (update_cr_attrs)

{
  "cr_id": "CODE-XXX",
  "attributes": {
    "minutesAssessment": 10,
    "minutesDiagnosis": 15,
    "minutesImplementation": 45
  }
}

Шаг 2: Заметки о выполнении (add_completion_notes)

{
  "cr_id": "CODE-XXX",
  "notes": "## Что было сделано\n\n- Действие 1\n- Действие 2\n\n## Результат\n\n- Итог"
}

Шаг 3: Статус (update_cr_status)

{
  "cr_id": "CODE-XXX",
  "new_status": "Implemented"
}

Порядок: часы → заметки → статус. Не меняй местами.

---

Взятие тикета в работу

{
  "cr_id": "CODE-XXX",
  "new_status": "In Progress"
}

---

Фильтрация тикетов

{
  "project": "PROJECT_CODE",
  "filters": {
    "status": "In Progress",
    "priority": ["High", "Critical"]
  }
}

---

Оценка времени

Время работы разбивается на 3 этапа для точного учёта:

Этап	Описание	Типичное время
minutesAssessment	Изучение задачи, чтение ТЗ	5–30 мин
minutesDiagnosis	Анализ кода, поиск решения	10–60 мин
minutesImplementation	Непосредственно выполнение работы	15–180 мин

Альтернативно можно указать общее время: hours: 1.5

---

Чек-лист завершения тикета

• Работа выполнена и проверена
• Часы заполнены (update_cr_attrs)
• Заметки добавлены (add_completion_notes)
• Статус = Implemented (update_cr_status)