linear は何をしますか？
概要
このスキルは、Linear の課題、プロジェクト、およびチームワークフローを管理するための構造化されたワークフローを提供します。Linear MCP サーバーとの一貫した統合を実現し、課題、プロジェクト、ドキュメント、およびチームコラボレーションのための自然言語プロジェクト管理を提供します。
前提条件
- Linear MCP サーバーが接続され、OAuth 経由でアクセス可能であること
- 関連する Linear ワークスペース、チーム、およびプロジェクトへのアクセス権があることを確認する
必要なワークフロー
以下の手順を順番に実行してください。手順をスキップしないでください。
ステップ 0: Linear MCP のセットアップ（未構成の場合）
MCP 呼び出しが Linear MCP の未接続により失敗した場合は、一時停止してセットアップを行います。
- Linear MCP を追加する:
codex mcp add linear --url https://mcp.linear.app/mcp
- リモート MCP クライアントを有効にする:
config.tomlで[features] rmcp_client = trueを設定する またはcodex --enable rmcp_clientを実行する
- 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 ツール呼び出しを論理的なバッチで実行します:
- 最初に読み取り（リスト/取得/検索）を行い、コンテキストを構築します。
- 次に、必要なすべてのフィールドを指定して作成または更新（課題、プロジェクト、ラベル、コメント）を行います。
- 一括操作の場合は、変更を適用する前にグループ化ロジックを説明します。
ステップ 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 パフォーマンススプリント」）を作成してアサインを設定します。
- バグトリアージ: 重大/高優先度のバグを一覧表示し、ユーザー影響度でランク付けし、上位の項目を「進行中」に移動します。
- ドキュメント監査: ドキュメントを検索（例: API 認証）し、ギャップや古いセクションに対してラベル「documentation」が付いた課題を、詳細な修正内容とともに作成します。
- チームワークロードバランス: アクティブな課題をアサイン先ごとにグループ化し、負荷の高い担当者をフラグ付けし、再分配を提案または適用します。
- リリース計画: プロジェクト（例: 「v2.0 リリース」）をマイルストーン（機能凍結、ベータ、ドキュメント、ローンチ）とともに作成し、見積もり付きの課題を生成します。
- クロスプロジェクト依存関係: すべての「blocked」課題を検索し、ブロッカーを特定し、不足している場合はリンクされた課題を作成します。
- 自動ステータス更新: 更新が滞っている自分が担当の課題を検索し、現在の状態/ブロッカーに基づいてステータスコメントを追加します。
- スマートラベリング: ラベルなしの課題を分析し、ラベルを提案/適用し、不足しているラベルカテゴリを作成します。
- スプリントレトロスペクティブ: 最後に完了したサイクルのレポートを生成し、完了した作業と先送りされた作業を記録し、パターンについて議論するための課題を作成します。
生産性を最大化するためのヒント
- 関連する変更はバッチ処理します。繰り返し発生する課題構造にはスマートテンプレートの使用を検討します。
- 可能な場合は自然言語クエリを使用します（「今週ジョンが取り組んでいるものを表示して」）。
- コンテキストを活用します。新しいリクエストで以前の課題を参照します。
- 大規模な更新は、レート制限を回避するために小さなバッチに分割します。頻繁にリストする場合はフィルターをキャッシュまたは再利用します。
トラブルシューティング
- 認証: ブラウザの Cookie をクリアし、OAuth を再実行し、ワークスペースの権限を確認し、API アクセスが有効になっていることを確認します。
- ツール呼び出しエラー: モデルが複数のツール呼び出しをサポートしていることを確認し、すべての必須フィールドを指定し、複雑なリクエストは分割します。
- データ欠落: トークンをリフレッシュし、ワークスペースへのアクセスを確認し、アーカイブされたプロジェクトがないか確認し、正しいチームが選択されていることを確認します。
- パフォーマンス: Linear API のレート制限に注意してください。一括操作はバッチ処理し、具体的なフィルターを使用するか、頻繁なクエリをキャッシュします。