Linear Project Management

概要

Linear Project Management は wrsmith108/linear-claude-skill で、Linear のイシュー、プロジェクト、チームを管理する MIT ライセンスの Claude Code スキルです。アクセス経路は3層構成で、単純な操作は公式 Linear MCP サーバー、複数ステップの自動化は TypeScript SDK スクリプト、それ以外は GraphQL を直接使います。SKILL.md がどの経路を使うかを Claude に指示し、api.md・sdk.md・sync.md・projects.md などの参照ファイルは必要なときだけ読み込まれます。

主な機能

• 高レベル操作：npm run ops でイニシアチブ・プロジェクト作成、サブイシュー作成、親子関係の設定、ステータスの一括更新。
• 作成前の重複確認：既存のプロジェクトやイシューを先に検索。
• ラベル体系：ドメイン別ラベルで分類とエージェントのルーティングを統一（docs/labels.md）。
• 一括同期：CLI、エージェント、hooks からコード変更を Linear に同期。
• 画像アップロード：Linear のストレージにアップロードしてイシューに添付。
• セットアップチェック：npm run setup で不足している設定を具体的に表示。
• Rust 製 lin CLI による高速経路（任意）と SDK への自動フォールバック。

クイックスタート

git clone https://github.com/wrsmith108/linear-claude-skill ~/.claude/skills/linear
cd ~/.claude/skills/linear && npm install
npm run setup
export LINEAR_API_KEY="lin_api_..."   # Linear > Settings > Security & access > Personal API keys
npm run ops -- whoami
npm run ops -- create-sub-issue ENG-100 "Add tests" "Unit tests for feature"
npm run ops -- status Done ENG-123 ENG-124

npm run build で esbuild による事前コンパイルを行うとコールドスタートが速くなります（未ビルドでも tsx 経由で動作）。README は mcp.linear.app の公式 MCP サーバーを推奨し、非推奨のコミュニティ版 Linear MCP を使わないよう注意しています。

使いどころ

• Claude と作った計画を Linear のイニシアチブ・プロジェクト・サブイシューに落とし込む。
• マージ後に複数のイシューをまとめてクローズ・移動する。
• 実際にリリースした内容と Linear を同期させる。

制限事項

• Linear アカウントと、ワークスペースにアクセスできる個人 API キーが必要です。
• Node.js が必要。lin CLI と MCP サーバーは別途インストールする任意コンポーネントです。

よくある質問

Linear MCP サーバーは必須ですか？

単純な操作には推奨ですが、LINEAR_API_KEY だけでも SDK スクリプトと GraphQL は動作します。

コマンド一覧はどう確認しますか？

npm run ops -- help を実行します。

代替ツール

• チームが Feishu/Lark でタスク管理しているなら Lark CLI。
• Planning with Files：計画をトラッカーではなくリポジトリ内の Markdown で管理。
• Zapier：Linear と他アプリをノーコードで連携。

関連は Skills カテゴリ と プロジェクト管理タグ へ。