mcpField
L
linear

linear

github.com/johnlindquist開発2637 回インストール45 週間前に更新
リポジトリ

linear について

linear は、linearis CLI で Linear の課題を管理するスキルです。コマンドラインで作業する開発チーム向けに、検索、更新、コメント、チームやプロジェクトの参照を提供します。

主な機能

  1. 01課題の一覧表示と検索
  2. 02課題の詳細確認
  3. 03課題の作成と更新
  4. 04コメントの追加
  5. 05チーム、ラベル、プロジェクト、サイクルの一覧表示

活用シーン

  1. 01チームや担当者で課題を絞り込む
  2. 02課題のステータスを進め、進捗を記録する
  3. 03課題に担当者と優先度を設定する

インストール

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

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

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

詳細

Linear Issue Manager

linearis CLI を使用して Linear の課題を管理します。

前提条件

linearis CLI をインストールします：

bun add -g linearis

API トークンを設定します：

export LINEAR_API_KEY=lin_api_xxxxx

API キーは、Linear Settings > API > Personal API keys から取得できます。

CLI リファレンス

課題の一覧表示
# List issues (default: 25)
linearis issues list

# Limit results
linearis issues list --limit 10
課題の検索
# Search by query
linearis issues search "bug"

# Filter by team
linearis issues search "authentication" --team ENG

# Filter by assignee
linearis issues search "feature" --assignee user-id

# Filter by project
linearis issues search "api" --project "Backend"

# Filter by status
linearis issues search "bug" --status "In Progress,Todo"

# Combined filters with limit
linearis issues search "urgent" --team ENG --limit 5
課題の詳細を取得
# Read issue by ID or identifier
linearis issues read ENG-123
linearis issues read abc123-uuid
課題の作成
# Basic issue (requires team)
linearis issues create "Fix login bug" --team ENG

# With description
linearis issues create "Add OAuth support" --team ENG -d "Implement Google OAuth"

# With priority (1=Urgent, 2=High, 3=Medium, 4=Low)
linearis issues create "Critical fix" --team ENG -p 1

# With assignee
linearis issues create "Review code" --team ENG --assignee user-id

# With labels
linearis issues create "Security issue" --team ENG --labels "bug,security"

# With project
linearis issues create "New feature" --team ENG --project "Q1 Roadmap"

# With status
linearis issues create "Started task" --team ENG --status "In Progress"

# Full example
linearis issues create "Implement caching" \
  --team ENG \
  -d "Add Redis caching for API responses" \
  -p 2 \
  --labels "feature,performance" \
  --project "Backend" \
  --status "Todo"
課題の更新
# Update title
linearis issues update ENG-123 -t "New title"

# Update description
linearis issues update ENG-123 -d "Updated description"

# Change status
linearis issues update ENG-123 -s "In Progress"
linearis issues update ENG-123 -s "Done"

# Change priority
linearis issues update ENG-123 -p 1

# Change assignee
linearis issues update ENG-123 --assignee user-id

# Add labels (default mode: adding)
linearis issues update ENG-123 --labels "urgent,blocked"

# Replace all labels
linearis issues update ENG-123 --labels "new-label" --label-by overwriting

# Clear all labels
linearis issues update ENG-123 --clear-labels

# Set parent issue
linearis issues update ENG-123 --parent-ticket ENG-100

# Clear parent
linearis issues update ENG-123 --clear-parent-ticket

# Set cycle
linearis issues update ENG-123 --cycle "Sprint 5"

# Clear cycle
linearis issues update ENG-123 --clear-cycle
コメント
# Add comment to issue
linearis comments create ENG-123 --body "Working on this now"
チーム
# List all teams
linearis teams list
ラベル
# List all labels
linearis labels list
プロジェクト
# List projects
linearis projects list
サイクル
# List cycles
linearis cycles list
ユーザー
# List users
linearis users list

ワークフローパターン

課題への着手
# 1. Find the issue
linearis issues search "feature name" --team ENG

# 2. Get details
linearis issues read ENG-123

# 3. Update status to In Progress
linearis issues update ENG-123 -s "In Progress"

# 4. Create branch (from issue identifier)
git checkout -b eng-123-feature-name
課題の完了
# 1. Update status
linearis issues update ENG-123 -s "Done"

# 2. Add completion comment
linearis comments create ENG-123 --body "Completed in PR #456"
毎日のスタンドアップビュー
# My in-progress issues
linearis issues search "assignee:me" --status "In Progress"

# Team's blocked issues
linearis issues search "" --team ENG --status "Blocked"
バグのトリアージ
# Find unassigned bugs
linearis issues search "label:bug" --team ENG

# Assign and prioritize
linearis issues update ENG-456 --assignee user-id -p 1

Git 連携

コミットを紐付ける

コミットメッセージに課題 ID を記載します：

git commit -m "feat: implement caching

Fixes ENG-123"
課題へのリンク付き PR を作成
ISSUE_ID="ENG-123"
gh pr create --title "feat: implement caching" --body "Closes $ISSUE_ID"

優先度の値

値意味
0優先度なし
1緊急
2高
3中
4低

ベストプラクティス

  1. 課題 ID を使用する - コミットや PR で ENG-123 を参照します
  2. ステータスを更新する - linearis issues update でワークフローに沿って課題を進めます
  3. コメントを追加する - linearis comments create で進捗を記録します
  4. ラベルを使用する - フィルタリングできるよう分類します
  5. PR を紐付ける - コードを課題に関連付けます
  6. 効果的に検索する - フィルターを組み合わせて、正確な結果を得ます

コメント

Markdown 対応