mcpField
L
linear

linear

github.com/davila7生産性33.0k373 回インストール1 日前に更新
リポジトリ

linear について

linear スキルは、Linear の課題、プロジェクト、チーム連携を管理するための手順を提供します。プロジェクト管理を行うエージェント向けで、Linear MCP を通じた変更の前に状況を確認し、操作をまとめます。

主な機能

  1. 01目標と範囲を段階的に確認
  2. 02課題とプロジェクトの検索・管理
  3. 03チームやサイクルのワークフロー
  4. 04操作をまとめて実行し結果を要約

活用シーン

  1. 01スプリントの計画と課題の割り当て
  2. 02バグのトリアージと状態変更
  3. 03ドキュメント監査と課題の起票
  4. 04チーム負荷とプロジェクト間の阻害要因の確認

MCP 対応

OAuth 認証済みの Linear MCP サーバーへの接続が前提です。課題、プロジェクト、ラベル、コメント、ドキュメントの読み取りや作成に MCP ツールを使う手順を示します。

インストール

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

$npx skills add https://github.com/davila7/claude-code-templates --skill linear

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

詳細

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 対応