Работа с задачами в Linear
Читает, создаёт и обновляет задачи, проекты и циклы в Linear через MCP-сервер: планирование спринта, разбор багов, ретроспективы.
- Что делает
- Читает, создаёт и обновляет задачи, проекты и циклы в Linear через MCP-сервер: планирование спринта, разбор багов, ретроспективы.
- Когда брать
- Когда нужно прочитать, создать или обновить тикеты и проекты в Linear.
- Когда не брать
- Если рабочее пространство Linear недоступно или MCP-сервер не подключён.
- Пример запроса
- Посмотри открытые баги нашей команды в Linear и предложи, какие взять в спринт.
- Нужно подключить
- MCP-сервер Linear, аккаунт Linear
Как включить
- Скачайте архив и распакуйте его.
- Положите папку
linearв~/.agents/skills/. - Вызовите скилл командой
$linearили найдите его через/skills.
Текст
---
name: linear
description: Управляй задачами, проектами и командными процессами в Linear. Используй, когда пользователь хочет прочитать, создать или обновить тикеты в Linear.
metadata:
short-description: Manage Linear issues in Codex
---
Linear
Обзор
Этот скилл задаёт структурированный рабочий процесс управления задачами, проектами и командными процессами в Linear. Он обеспечивает последовательную интеграцию с MCP-сервером Linear, который позволяет управлять задачами, проектами, документацией и командной работой на естественном языке.
Предварительные условия
- MCP-сервер Linear должен быть подключён и доступен через OAuth
- Убедись, что есть доступ к нужному рабочему пространству, командам и проектам Linear
Обязательный порядок работы
Выполняй шаги по порядку. Не пропускай шаги.
Шаг 0: Настрой MCP Linear (если ещё не настроен)
Если какой-либо вызов MCP не удался из-за того, что MCP Linear не подключён, остановись и настрой его:
- Добавь MCP Linear:
codex mcp add linear --url https://mcp.linear.app/mcp- Включи удалённый клиент MCP:
- Задай
[features] rmcp_client = trueвconfig.tomlили запустиcodex --enable rmcp_client - Войди через OAuth:
codex mcp login linear
После успешного входа пользователю придётся перезапустить codex. Закончи ответ и сообщи ему об этом, чтобы при следующем обращении он мог продолжить с шага 1.
Примечание для Windows/WSL: если на Windows возникают ошибки соединения, попробуй настроить запуск MCP Linear через WSL:
{"mcpServers": {"linear": {"command": "wsl", "args": ["npx", "-y", "mcp-remote", "https://mcp.linear.app/sse", "--transport", "sse-only"]}}}
Шаг 1
Уточни цель и объём работы пользователя (например, разбор задач, планирование спринта, аудит документации, балансировка нагрузки). При необходимости подтверди команду или проект, приоритет, метки, цикл и сроки.
Шаг 2
Выбери подходящий рабочий процесс (см. «Практические рабочие процессы» ниже) и определи, какие инструменты MCP Linear понадобятся. Перед вызовом инструментов подтверди нужные идентификаторы (ID задачи, ID проекта, ключ команды).
Шаг 3
Выполняй вызовы инструментов MCP Linear логичными пакетами:
- Сначала чтение (list/get/search), чтобы собрать контекст.
- Затем создание или обновление (задачи, проекты, метки, комментарии) со всеми обязательными полями.
- При массовых операциях объясни логику группировки, прежде чем вносить изменения.
Шаг 4
Подведи итоги, отметь оставшиеся пробелы и препятствия и предложи дальнейшие действия (дополнительные задачи, изменение меток, назначения или повторные комментарии).
Доступные инструменты
Управление задачами: list_issues, get_issue, create_issue, update_issue, list_my_issues, list_issue_statuses, list_issue_labels, create_issue_label
Проекты и команды: list_projects, get_project, create_project, update_project, list_teams, get_team, list_users
Документация и сотрудничество: list_documents, get_document, search_documentation, list_comments, create_comment, list_cycles
Практические рабочие процессы
- Планирование спринта: просмотри открытые задачи целевой команды, выбери главные по приоритету и создай новый цикл (например, «Q1 Performance Sprint») с назначениями.
- Разбор багов: выведи критические и высокоприоритетные баги, ранжируй их по влиянию на пользователей и переведи главные в статус «In Progress».
- Аудит документации: найди документацию (например, по авторизации API), затем открой задачи с меткой «documentation» по пробелам и устаревшим разделам с подробными исправлениями.
- Балансировка нагрузки в команде: сгруппируй активные задачи по исполнителям, отметь тех, у кого высокая нагрузка, и предложи или выполни перераспределение.
- Планирование релиза: создай проект (например, «v2.0 Release») с вехами (заморозка функций, бета, документация, запуск) и сформируй задачи с оценками.
- Зависимости между проектами: найди все заблокированные («blocked») задачи, определи блокирующие и при отсутствии создай связанные задачи.
- Автоматические обновления статуса: найди свои задачи с устаревшими обновлениями и добавь комментарии о статусе по текущему состоянию и блокерам.
- Умная разметка метками: проанализируй задачи без меток, предложи или проставь метки и создай недостающие категории меток.
- Ретроспективы спринтов: сформируй отчёт по последнему завершённому циклу, отметь выполненное и перенесённое и открой задачи для обсуждения повторяющихся проблем.
Советы для максимальной продуктивности
- Группируй связанные изменения в пакеты; для повторяющихся структур задач подумай об умных шаблонах.
- По возможности используй запросы на естественном языке («Покажи, над чем Джон работает на этой неделе»).
- Опирайся на контекст: ссылайся на прежние задачи в новых запросах.
- Делай крупные обновления небольшими пакетами, чтобы не упереться в лимиты; при частых выборках кэшируй или переиспользуй фильтры.
Устранение неполадок
- Авторизация: очисти cookie браузера, заново пройди OAuth, проверь права на рабочее пространство, убедись, что доступ к API включён.
- Ошибки вызова инструментов: убедись, что модель поддерживает несколько вызовов инструментов, укажи все обязательные поля и раздели сложные запросы.
- Нет данных: обнови токен, проверь доступ к рабочему пространству, проверь архивные проекты и убедись, что выбрана правильная команда.
- Производительность: помни о лимитах запросов к API Linear; группируй массовые операции в пакеты, используй точные фильтры или кэшируй частые запросы.
Перевод: iiuniversitet. Оригинал: https://github.com/openai/skills/tree/main/skills/.curated/linear, лицензия Apache-2.0. Изменения: перевод на русский язык.
Оригинал на английском
---
name: linear
description: Manage issues, projects & team workflows in Linear. Use when the user wants to read, create or updates tickets in Linear.
metadata:
short-description: Manage Linear issues in Codex
---
# Linear
## Overview
This skill provides a structured workflow for managing issues, projects & team workflows in Linear. It ensures consistent integration with the Linear MCP server, which offers natural-language project management for issues, projects, documentation, and team collaboration.
## Prerequisites
- Linear MCP server must be connected and accessible via OAuth
- Confirm access to the relevant Linear workspace, teams, and projects
## Required Workflow
**Follow these steps in order. Do not skip steps.**
### Step 0: Set up Linear MCP (if not already configured)
If any MCP call fails because Linear MCP is not connected, pause and set it up:
1. Add the Linear MCP:
- `codex mcp add linear --url https://mcp.linear.app/mcp`
2. Enable remote MCP client:
- Set `[features] rmcp_client = true` in `config.toml` **or** run `codex --enable rmcp_client`
3. Log in with OAuth:
- `codex mcp login linear`
After successful login, the user will have to restart codex. You should finish your answer and tell them so when they try again they can continue with Step 1.
**Windows/WSL note:** If you see connection errors on Windows, try configuring the Linear MCP to run via WSL:
```json
{"mcpServers": {"linear": {"command": "wsl", "args": ["npx", "-y", "mcp-remote", "https://mcp.linear.app/sse", "--transport", "sse-only"]}}}
```
### Step 1
Clarify the user's goal and scope (e.g., issue triage, sprint planning, documentation audit, workload balance). Confirm team/project, priority, labels, cycle, and due dates as needed.
### Step 2
Select the appropriate workflow (see Practical Workflows below) and identify the Linear MCP tools you will need. Confirm required identifiers (issue ID, project ID, team key) before calling tools.
### Step 3
Execute Linear MCP tool calls in logical batches:
- Read first (list/get/search) to build context.
- Create or update next (issues, projects, labels, comments) with all required fields.
- For bulk operations, explain the grouping logic before applying changes.
### Step 4
Summarize results, call out remaining gaps or blockers, and propose next actions (additional issues, label changes, assignments, or follow-up comments).
## Available Tools
Issue Management: `list_issues`, `get_issue`, `create_issue`, `update_issue`, `list_my_issues`, `list_issue_statuses`, `list_issue_labels`, `create_issue_label`
Project & Team: `list_projects`, `get_project`, `create_project`, `update_project`, `list_teams`, `get_team`, `list_users`
Documentation & Collaboration: `list_documents`, `get_document`, `search_documentation`, `list_comments`, `create_comment`, `list_cycles`
## Practical Workflows
- Sprint Planning: Review open issues for a target team, pick top items by priority, and create a new cycle (e.g., "Q1 Performance Sprint") with assignments.
- Bug Triage: List critical/high-priority bugs, rank by user impact, and move the top items to "In Progress."
- Documentation Audit: Search documentation (e.g., API auth), then open labeled "documentation" issues for gaps or outdated sections with detailed fixes.
- Team Workload Balance: Group active issues by assignee, flag anyone with high load, and suggest or apply redistributions.
- Release Planning: Create a project (e.g., "v2.0 Release") with milestones (feature freeze, beta, docs, launch) and generate issues with estimates.
- Cross-Project Dependencies: Find all "blocked" issues, identify blockers, and create linked issues if missing.
- Automated Status Updates: Find your issues with stale updates and add status comments based on current state/blockers.
- Smart Labeling: Analyze unlabeled issues, suggest/apply labels, and create missing label categories.
- Sprint Retrospectives: Generate a report for the last completed cycle, note completed vs. pushed work, and open discussion issues for patterns.
## Tips for Maximum Productivity
- Batch operations for related changes; consider smart templates for recurring issue structures.
- Use natural queries when possible ("Show me what John is working on this week").
- Leverage context: reference prior issues in new requests.
- Break large updates into smaller batches to avoid rate limits; cache or reuse filters when listing frequently.
## Troubleshooting
- Authentication: Clear browser cookies, re-run OAuth, verify workspace permissions, ensure API access is enabled.
- Tool Calling Errors: Confirm the model supports multiple tool calls, provide all required fields, and split complex requests.
- Missing Data: Refresh token, verify workspace access, check for archived projects, and confirm correct team selection.
- Performance: Remember Linear API rate limits; batch bulk operations, use specific filters, or cache frequent queries.
Источник: openai/skills / linear ↗. Ссылка проверена 2026-10-10.