github-issues

Скилл GitHub Issues предназначен для управления задачами в GitHub через MCP и командные инструменты. Он подходит для bug report, feature request и обычных рабочих задач, когда нужно не просто открыть issue, а сохранить его в понятном состоянии и связать с текущим процессом. Источник прямо перечисляет операции чтения: получение данных issue, комментариев, подзадач и labels, список issues с фильтрами по состоянию, labels и датам, а также поиск по синтаксису GitHub. Отдельно предусмотрены операции с Projects: получение списка проектов, полей, элементов и status updates. Это позволяет сначала собрать контекст, а затем выбрать точное действие вместо изменения записи по предположению. Порядок работы начинается с определения цели: создать, обновить или найти задачу. Перед записью скилл рекомендует проверить репозиторий, существующие labels и milestones, если они нужны сценарию. Для создания issue предлагается использовать шаблон, соответствующий типу запроса: Bug Report для ошибки, Feature Request для новой возможности и Task для технической работы. В структуре запроса должны быть конкретные детали: описание, шаги воспроизведения и ожидаемое поведение для бага; мотивация, предлагаемое решение и acceptance criteria для функции; либо понятные границы работы для task. Заголовок должен быть предметным и коротким, а при использовании issue type не должен дублировать тип префиксом вроде [Bug]. MCP-инструменты в исходном документе отвечают прежде всего за чтение и работу с project-контекстом. Для создания, изменения и комментирования issues скилл использует gh api и показывает REST-команды с явными owner, repo и номером issue. Через этот интерфейс можно задать title, body, state, labels, assignees и milestone, а при создании также передать issue type. Для операции, где важны типы Bug, Feature, Task или Epic, рекомендуется REST API, потому что обычная команда gh issue create не поддерживает флаг --type. Если в организации доступны issue types, источник советует предпочитать их эквивалентным labels; labels остаются запасным вариантом, когда типы не настроены. Расширенные сценарии вынесены в отдельные reference-файлы: сложный поиск, sub-issues и родительские задачи, зависимости blocked-by и blocking, issue types, Projects V2, пользовательские issue fields и изображения в issue. Это важное ограничение области: основной SKILL.md не заменяет эти подробные инструкции, если требуется работать с датами, приоритетом, кастомными полями или иерархией задач. Перед созданием нужно подтвердить контекст репозитория и запросить критически важные отсутствующие сведения, а при обновлении сначала получить текущую issue, чтобы не затереть поля, которые пользователь не просил менять. После операции результатом должен быть подтверждённый URL issue, а связанные задачи следует явно связать только тогда, когда связь известна из контекста.