linear

linear skill の概要

linear skill は Linear MCP サーバーを通じて Linear を扱えるようにする skill です。これにより、エージェントはワークスペースの構造や運用ルールを推測することなく、issue の参照・作成・更新ができます。linear を Issue Tracking、トリアージ、プロジェクト調整、チームの作業を最新の issue 状態に揃える用途で使う人に特に向いています。

この skill の用途

正確な Linear データが必要な作業では、この linear skill を使ってください。たとえば、適切な issue を探す、ステータスを更新する、文脈を追加する、担当者を割り当てる、プロジェクトの進捗を確認する、といった場面です。単に助言文を作るだけでなく、実際の Linear ワークスペース内でエージェントを動かしたいなら、汎用プロンプトよりこちらが適しています。

どんな人に向いているか

すでに Linear を issue tracking に使っていて、トリアージキューの整理、チケットの整備、プロジェクトのフォローアップ、チーム横断の調整など、運用作業をエージェントに手伝ってほしい人は linear をインストールする価値があります。単なる文面生成ではなく、ワークフローの正確さを重視するユーザーに特に向いています。

判断のポイント

最大の前提条件は接続です。この skill には、接続済みの Linear MCP サーバーと OAuth ログインが必要です。ワークスペース、チーム、プロジェクトに制限がある場合は、権限が確認されるまで導入が止まることがあります。最大の価値は、文脈を踏まえた信頼できる Linear 操作ができることです。一方で、MCP の設定が済む前に skill が実行できると思い込むことが最大のリスクです。

linear skill の使い方

Linear MCP をインストールして接続する

linear を使うには、skill を追加し、結果を期待する前に MCP サーバーを接続してください。

codex mcp add linear --url https://mcp.linear.app/mcp
codex --enable rmcp_client
codex mcp login linear

ログインが成功したら、続ける前に Codex を再起動してください。Windows で接続に問題がある場合は、WSL ベースの MCP transport のほうが、作業できる状態に持っていくまでの近道になることがあります。

依頼内容を具体的にする

linear の使い方で最も成果が出るのは、漠然とした目的ではなく、具体的な操作を渡すときです。よい入力は、対象と変更内容をはっきり書きます。たとえば「ログイン失敗の bug report を探して In Progress に移し、阻害要因を要約して」とか、「オンボーディング docs 用の Linear issue を owner、priority、acceptance criteria 付きで作成して」のようにします。「Linear を整理して」のような依頼は、範囲、team、欲しい出力まで指定しない限り避けてください。

先に読むべきファイル

まず SKILL.md を読み、次にデフォルトの意図と MCP 依存関係を確認するために agents/openai.yaml を確認してください。再利用の前提を知りたい場合は LICENSE.txt も見てください。ブランド関連が必要なときだけ asset ファイルを確認すれば十分です。最重要なのは SKILL.md にある必須フローで、特に setup と clarification の手順です。

結果を良くするためのワークフローのコツ

Linear でエージェントに操作させたいときは、workspace、team、project、そして read-only か mutating かを伝えてください。issue の更新が必要なら、変更したい field を具体的に示し、priority、due date、assignee などの制約も添えます。MCP 接続がまだ整っていない場合は、skill はそこで止まり、続行前に setup を完了するよう案内するべきです。

linear skill FAQ

linear は issue tracking 専用ですか？

いいえ。linear の主な用途は Issue Tracking ですが、Linear 内の project update、team coordination、documentation 連動のワークフロー作業にも使えます。正解の情報源が Linear にあり、出力にもライブの workspace state を反映したいなら使うべきです。

linear skill と通常の prompt の違いは何ですか？

通常の prompt は「何をすべきか」を説明できますが、linear skill は接続済みの Linear ワークスペースに対して実際に実行するために作られています。real issue ID、最新 status、permissions、テキストだけの計画ではなく信頼できる更新が必要なときに、この違いが効いてきます。

初心者でも使いやすいですか？

はい、やることを明確に言えて、すでに Linear へのアクセスがあるなら使いやすいです。どの team、project、issue を変更すべきかまだ決めていない段階では、あまり初心者向けではありません。というのも、linear の案内入力は具体的であるほど精度が上がるからです。

どんなときに使わないほうがいいですか？

汎用的な project-management テンプレートだけが欲しい場合、Linear ワークスペースが接続されていない場合、あるいは作業を issue tracker の外に置いておくべき場合は、linear を使わないでください。また、ライブの Linear 操作を伴わず、広い発想出しだけをしたい場面にも向いていません。

linear skill の改善方法

Linear の文脈をより詳しく伝える

linear の案内入力で最も強いのは、workspace、team、project、issue title または link、そして具体的な操作内容を含むものです。トリアージの精度を上げたいなら、症状、priority の目安、関連 issue の参照も添えてください。そうすることで、エージェントが素早く曖昧さを解消できます。

望む最終状態を明示する

「この issue を手伝って」ではなく、作業後に Linear issue がどうなっていてほしいかを伝えてください。たとえば、status が変わっている、owner が設定されている、description が書き直されている、acceptance criteria が追加されている、重複が統合されている、などです。最終状態を明確にするとやり取りが減り、linear の動きも予測しやすくなります。

setup と権限エラーを確認する

最も多い失敗は、プロンプトそのものではなく、MCP アクセス不足や workspace 権限不足です。skill が接続できないなら、まず Linear MCP の setup を直してください。接続はできるのに操作できないなら、再試行する前に該当する team と project の権限を確認してください。

1回目の結果をもとに、より絞って調整する

最初の結果が広すぎる場合は、issue を1つ、team を1つ、project を1つというように絞ってください。繰り返し作業では、task type、scope、success criteria を含む安定した prompt パターンを再利用すると、linear skill は少ない修正で一貫した更新を返しやすくなります。