mcpField
L
linear

linear

github.com/openai生産性28.4k10.6k 回インストール18 週間前に更新
リポジトリ

linear について

linearは、接続済みのLinear MCPサーバーを通じて、Linearの課題、プロジェクト、チーム連携を管理するワークフロースキルです。範囲の確認と状況把握から変更、結果の要約までを段階的に進めます。

主な機能

  1. 01課題とプロジェクトの管理
  2. 02ドキュメントとコメントの検索
  3. 03サイクルとチームワークフローの計画
  4. 04関連するMCP操作の一括実行
  5. 05結果と阻害要因の要約

活用シーン

  1. 01バグのトリアージと優先順位付け
  2. 02スプリントやリリースの計画
  3. 03ドキュメントの不足箇所の監査
  4. 04チームの作業負荷の調整

MCP 対応

OAuthで接続したLinear MCPサーバーが必要です。そのツールを使い、課題、プロジェクト、チーム、ドキュメント、コラボレーション情報を読み取り、管理します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/openai/skills --skill linear

インストール後、Claude Code で/linearを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE.txt
agents/
openai.yaml
assets/
linear-small.svg

詳細

Linear

概要

このスキルは、Linear でのイシュー、プロジェクト、チームワークフローの管理に関する構造化されたワークフローを提供します。イシュー、プロジェクト、ドキュメント、チームコラボレーションに対する自然言語によるプロジェクト管理を提供する Linear MCP サーバーとの一貫した連携を保証します。

前提条件

  • Linear MCP サーバーに OAuth 経由で接続され、アクセスできている必要があります
  • 関連する Linear のワークスペース、チーム、プロジェクトへのアクセスを確認してください

必須ワークフロー

以下の手順を順番に実行してください。手順を飛ばさないでください。

ステップ 0: Linear MCP のセットアップ（未設定の場合）

Linear MCP が接続されていないために MCP の呼び出しが失敗した場合は、作業を中断してセットアップしてください:

  1. Linear MCP を追加します:
    • codex mcp add linear --url https://mcp.linear.app/mcp
  2. リモート MCP クライアントを有効にします:
    • config.toml に [features] rmcp_client = true を設定するか、codex --enable rmcp_client を実行します
  3. OAuth でログインします:
    • codex mcp login linear

ログインに成功すると、ユーザーは codex を再起動する必要があります。回答を完了させ、次回再度試すときはステップ 1 から続行できることをユーザーに伝えてください。

Windows/WSL に関する注意: Windows で接続エラーが発生する場合は、Linear MCP を WSL 経由で実行するように設定してみてください:

{"mcpServers": {"linear": {"command": "wsl", "args": ["npx", "-y", "mcp-remote", "https://mcp.linear.app/sse", "--transport", "sse-only"]}}}
ステップ 1

ユーザーの目的と範囲を明確にします（例: イシューのトリアージ、スプリント計画、ドキュメント監査、ワークロードのバランス調整）。必要に応じて、チーム/プロジェクト、優先度、ラベル、サイクル、期限を確認してください。

ステップ 2

適切なワークフローを選択し（後述の実用的なワークフローを参照）、必要な Linear MCP ツールを特定します。ツールを呼び出す前に、必要な識別子（イシュー ID、プロジェクト ID、チームキー）を確認してください。

ステップ 3

Linear MCP のツール呼び出しを論理的なバッチに分けて実行します:

  • まず読み取り（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」のイシューをすべて見つけ、ブロッカーを特定し、不足している場合はリンクされたイシューを作成します。
  • 自動ステータス更新: 更新が古くなっている自分のイシューを見つけ、現在の状態やブロッカーに基づいてステータスコメントを追加します。
  • スマートラベリング: ラベルの付いていないイシューを分析し、ラベルを提案または適用して、不足しているラベルカテゴリを作成します。
  • スプリントの振り返り: 直近の完了済みサイクルのレポートを生成し、完了した作業と次に回された作業を整理して、傾向について議論するイシューを作成します。

生産性を最大化するためのヒント

  • 関連する変更はまとめて一括処理し、定型的な課題の構造にはスマートテンプレートの利用を検討してください。
  • 可能であれば自然な言い回しで問い合わせてください（例：「John が今週作業している内容を見せて」）。
  • 文脈を活用してください。新しいリクエストで過去の課題を参照できます。
  • レート制限を避けるため、大きな更新は小さなバッチに分割してください。頻繁に一覧表示する場合は、フィルターをキャッシュするか再利用してください。

トラブルシューティング

  • 認証：ブラウザーの Cookie を消去し、OAuth を再実行して、ワークスペースの権限を確認し、API アクセスが有効になっていることを確認してください。
  • ツール呼び出しのエラー：モデルが複数のツール呼び出しに対応していることを確認し、必要なフィールドをすべて指定し、複雑なリクエストは分割してください。
  • データが表示されない：トークンを更新し、ワークスペースへのアクセスを確認し、アーカイブされたプロジェクトがないかを調べ、正しいチームが選択されていることを確認してください。
  • パフォーマンス：Linear API のレート制限に注意してください。一括操作はまとめて実行し、具体的なフィルターを使うか、頻繁に使うクエリをキャッシュしてください。

コメント

Markdown 対応