このスキルを使用する時期

Linear の課題、プロジェクト、チームを管理します

Linear の課題、プロジェクト、チームを管理する場合にこのスキルを使用します。

Linear

Linear で課題、プロジェクト、チームを管理するためのツールとワークフローです。

---

⚠️ ツールの利用可能性（まず読んでください）

このスキルは複数のツールバックエンドに対応しています。利用可能なものをご使用ください：

1. MCP ツール (mcp__linear) - ツールセットで利用可能な場合は使用
2. Linear CLI (linear コマンド) - Bash 経由で常に利用可能
3. ヘルパースクリプト - 複雑な操作用

MCP ツールが利用できない場合は、Bash 経由で Linear CLI を使用します：

# 課題を表示
linear issues view ENG-123

# 課題を作成
linear issues create --title "課題のタイトル" --description "説明"

# 課題ステータスを更新（ステート ID を先に取得）
linear issues update ENG-123 -s "STATE_ID"

# コメントを追加
linear issues comment add ENG-123 -m "コメントテキスト"

# 課題をリスト表示
linear issues list

「MCP ツールが利用できない」を障害として報告しないでください - 代わりに CLI を使用します。

---

このスキルを使用する時期

Linear の課題、プロジェクト、チームを管理します

Linear の課題、プロジェクト、チームを管理する場合にこのスキルを使用します。

🔐 セキュリティ：Varlock インテグレーション

重要：API キーをターミナルの出力や Claude のコンテキストに露出させないでください。

安全なコマンド（常に使用）

# LINEAR_API_KEY が設定されているか確認（マスクされた出力）
varlock load 2>&1 | grep LINEAR

# シークレットをインジェクションして実行
varlock run -- npx tsx scripts/query.ts "query { viewer { name } }"

# スキーマを確認（安全 - 値なし）
cat .env.schema | grep LINEAR

危険なコマンド（絶対に使用しない）

# ❌ 絶対に使用しない - キーを Claude のコンテキストに露出させる
linear config show
echo $LINEAR_API_KEY
printenv | grep LINEAR
cat .env

新規プロジェクト用のセットアップ

1. @sensitive アノテーション付きで .env.schema を作成：

   # @type=string(startsWith=lin_api_) @required @sensitive
   LINEAR_API_KEY=
   

2. .env に LINEAR_API_KEY を追加（このファイルはコミットしないでください）

3. MCP が環境変数を使用するように設定：

   {
     "mcpServers": {
       "linear": {
         "env": { "LINEAR_API_KEY": "${LINEAR_API_KEY}" }
       }
     }
   }
   

4. 操作前に varlock load を使用して検証

---

クイックスタート（初めてのユーザー向け）

1. セットアップを確認

セットアップチェックを実行して設定を確認します：

npx tsx ~/.claude/skills/linear/scripts/setup.ts

以下の項目を確認します：

• LINEAR_API_KEY が設定され有効か
• @linear/sdk がインストール済みか
• Linear CLI が利用可能か（オプション）
• MCP 設定（オプション）

2. API キーを取得（必要な場合）

セットアップで API キーが見つからないと報告された場合：

1. ブラウザで Linear を開く
2. 設定（歯車アイコン）→ セキュリティとアクセス → 個人用 API キー に移動
3. キーを作成 をクリックしてキーをコピー（lin_api_ で始まります）
4. 環境に追加：

# オプション A：シェルプロファイルに追加（~/.zshrc または ~/.bashrc）
export LINEAR_API_KEY="lin_api_your_key_here"

# オプション B：Claude Code 環境に追加
echo 'LINEAR_API_KEY=lin_api_your_key_here' >> ~/.claude/.env

# その後、シェルをリロードするか Claude Code を再起動

3. 接続をテスト

すべてが機能することを確認：

npx tsx ~/.claude/skills/linear/scripts/query.ts "query { viewer { name } }"

Linear から自分の名前が表示されるはずです。

4. 一般的な操作

# プロジェクトで課題を作成
npx tsx scripts/linear-ops.ts create-issue "プロジェクト" "タイトル" "説明"

# 課題ステータスを更新
npx tsx scripts/linear-ops.ts status Done ENG-123 ENG-124

# サブ課題を作成
npx tsx scripts/linear-ops.ts create-sub-issue ENG-100 "サブタスク" "詳細"

# プロジェクトステータスを更新
npx tsx scripts/linear-ops.ts project-status "Phase 1" completed

# すべてのコマンドを表示
npx tsx scripts/linear-ops.ts help

完全なリファレンスについては プロジェクト管理コマンド を参照してください。

---

このスキルを使用する時期

Linear の課題、プロジェクト、チームを管理します

Linear の課題、プロジェクト、チームを管理する場合にこのスキルを使用します。

プロジェクト計画ワークフロー

最初から正しいプロジェクトで課題を作成する

ベストプラクティス：新しいフェーズやイニシアチブを計画する場合は、プロジェクトとその課題を単一の計画セッションで一緒に作成します。課題を一般的なプロジェクトに作成して、後で移動させることは避けてください。

推奨ワークフロー

1. 最初にプロジェクトを作成：

   npx tsx scripts/linear-ops.ts create-project "Phase X: 機能名" "マイ・イニシアチブ"
   

2. プロジェクトの状態を「Planned」に設定：

   npx tsx scripts/linear-ops.ts project-status "Phase X: 機能名" planned
   

3. プロジェクト内に直接課題を作成：

   npx tsx scripts/linear-ops.ts create-issue "Phase X: 機能名" "親タスク" "説明"
   npx tsx scripts/linear-ops.ts create-sub-issue ENG-XXX "サブタスク 1" "説明"
   npx tsx scripts/linear-ops.ts create-sub-issue ENG-XXX "サブタスク 2" "説明"
   

4. 作業開始時にプロジェクト状態を更新：

   npx tsx scripts/linear-ops.ts project-status "Phase X: 機能名" in-progress
   

なぜこれが重要か

• 追跡可能性：課題は作成時からプロジェクトにリンク
• メトリクス：プロジェクト進捗追跡は初日から正確
• ワークフロー：プロジェクト間で課題を移動する時間が不要
• 組織：Linear のビューとフィルタが正しく機能

避けるべきアンチパターン

❌ 「保留」プロジェクトで課題を作成して後で移動：

# これはしないでください
create-issue "Phase 6A" "新機能"  # 誤ったプロジェクト
# 後で：手動で Phase X に移動      # 余分な作業

---

プロジェクト管理コマンド

project-status

Linear でプロジェクトの状態を更新します。Linear の API にマップされるユーザーフレンドリーな用語を受け入れます。

npx tsx scripts/linear-ops.ts project-status <プロジェクト名> <状態>

有効な状態：

入力	説明	API 値
backlog	まだ開始されていない	backlog
planned	将来の予定	planned
in-progress	現在進行中	started
paused	一時的に保留中	paused
completed	正常に完了	completed
canceled	実施しない	canceled

例：

# プロジェクトを開始
npx tsx scripts/linear-ops.ts project-status "Phase 8: MCP Decision Engine" in-progress

# プロジェクトを完了として標記
npx tsx scripts/linear-ops.ts project-status "Phase 8" completed

# 部分的な名前マッチングが機能
npx tsx scripts/linear-ops.ts project-status "Phase 8" paused

link-initiative

既存のプロジェクトをイニシアチブにリンク。

npx tsx scripts/linear-ops.ts link-initiative <プロジェクト名> <イニシアチブ名>

例：

# プロジェクトをイニシアチブにリンク
npx tsx scripts/linear-ops.ts link-initiative "Phase 8: MCP Decision Engine" "Q1 Goals"

# 部分的なマッチングが機能
npx tsx scripts/linear-ops.ts link-initiative "Phase 8" "Q1 Goals"

unlink-initiative

プロジェクトをイニシアチブから削除。

npx tsx scripts/linear-ops.ts unlink-initiative <プロジェクト名> <イニシアチブ名>

例：

# 誤ったリンクを削除
npx tsx scripts/linear-ops.ts unlink-initiative "Phase 8" "Linear Skill"

# テストリンクをクリーンアップ
npx tsx scripts/linear-ops.ts unlink-initiative "Test Project" "Q1 Goals"

エラーハンドリング：

• プロジェクトが指定されたイニシアチブにリンクされていない場合はエラーを返す
• プロジェクトまたはイニシアチブが見つからない場合はエラーを返す

プロジェクトのライフサイクル完全例

# 1. イニシアチブにリンクされたプロジェクトを作成
npx tsx scripts/linear-ops.ts create-project "Phase 11: New Feature" "Q1 Goals"

# 2. 状態を計画済みに設定
npx tsx scripts/linear-ops.ts project-status "Phase 11" planned

# 3. プロジェクトで課題を作成
npx tsx scripts/linear-ops.ts create-issue "Phase 11" "親タスク" "説明"
npx tsx scripts/linear-ops.ts create-sub-issue ENG-XXX "サブタスク 1" "詳細"

# 4. 作業開始 - 進行中に更新
npx tsx scripts/linear-ops.ts project-status "Phase 11" in-progress

# 5. 課題を完了にマーク
npx tsx scripts/linear-ops.ts status Done ENG-XXX ENG-YYY

# 6. プロジェクトを完了
npx tsx scripts/linear-ops.ts project-status "Phase 11" completed

# 7. （オプション）追加のイニシアチブにリンク
npx tsx scripts/linear-ops.ts link-initiative "Phase 11" "Q2 Goals"

---

このスキルを使用する時期

Linear の課題、プロジェクト、チームを管理します

Linear の課題、プロジェクト、チームを管理する場合にこのスキルを使用します。

ツール選択

タスクに適したツールを選択：

ツール	使用時機
MCP（公式サーバー）	ほとんどの操作 - 推奨
ヘルパースクリプト	バルク操作、MCP が利用できないときは
SDK スクリプト	複雑な操作（ループ、条件分岐）
GraphQL API	MCP/SDK でサポートされていない操作

MCP サーバー構成

mcp.linear.app の公式 Linear MCP サーバーを使用：

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.linear.app/sse"],
      "env": { "LINEAR_API_KEY": "your_api_key" }
    }
  }
}

警告：非推奨のコミュニティサーバーを使用しないでください。詳細は troubleshooting.md を参照してください。

MCP の信頼性（公式サーバー）

操作	信頼性	注釈
課題を作成	✅ 高	完全サポート
ステータスを更新	✅ 高	state: "Done" を直接使用
課題をリスト/検索	✅ 高	フィルタ、クエリをサポート
コメントを追加	✅ 高	課題 ID で機能

クイックステータス更新

# MCP 経由 - 人が読める形式のステート名を使用
update_issue with id="issue-uuid", state="Done"

# ヘルパースクリプト経由（バルク操作）
node scripts/linear-helpers.mjs update-status Done 123 124 125

ヘルパースクリプトリファレンス

ヘルパースクリプトの使用方法の詳細は troubleshooting.md を参照。

並列エージェント実行

バルク操作またはバックグラウンド実行の場合は、Linear-specialist サブエージェントを使用します：

Task({
  description: "Linear 課題を更新",
  prompt: "ENG-101、ENG-102、ENG-103 を完了にマーク",
  subagent_type: "Linear-specialist"
})

Linear-specialist（並列）を使用する場合：

• バルクステータス更新（3 課題以上）
• プロジェクトステータス変更
• 複数の課題作成
• コード変更後の同期操作

直接実行を使用する場合：

• 単一課題クエリ
• 課題の詳細表示
• クイックステータスチェック
• 即座の結果が必要な操作

並列実行パターンについては sync.md を参照。

重要な要件

課題 → プロジェクト → イニシアチブ

すべての課題はプロジェクトに添付されている必要があります。すべてのプロジェクトはイニシアチブにリンクされている必要があります。

エンティティ	リンク先	見つからない場合
課題	プロジェクト	プロジェクトボードに表示されない
プロジェクト	イニシアチブ	ロードマップに表示されない

完全なプロジェクト作成チェックリストについては projects.md を参照。

---

規約

課題ステータス

• 自分に割り当てられた：state: "Todo" に設定
• 割り当てなし：state: "Backlog" に設定

ラベル

ドメインベースのラベル分類 を使用。docs/labels.md を参照。

重要なルール：

• 1 つのタイプラベル：feature、bug、refactor、chore、spike
• 1～2 のドメインラベル：security、backend、frontend など
• 必要に応じてスコープラベル：blocked、breaking-change、tech-debt

# ラベルを検証
npx tsx scripts/linear-ops.ts labels validate "feature,security"

# 課題のラベルを提案
npx tsx scripts/linear-ops.ts labels suggest "XSS 脆弱性を修正"

SDK オートメーションスクリプト

MCP ツールが不十分な場合のみ使用。 ループ、マッピング、またはバルク更新を含む複雑な操作の場合は、@linear/sdk を使用して TypeScript スクリプトを作成します。sdk.md を参照：

• 完全なスクリプトパターンとテンプレート
• 一般的なオートメーション例（バルク更新、フィルタリング、レポート）
• ツール選択基準

スクリプトは完全なタイプヒントを提供し、複数ステップの操作では生の GraphQL より デバッグしやすいです。

GraphQL API

フォールバックのみ。 MCP または SDK でサポートされていない操作の場合に使用します。

完全なドキュメントについては api.md を参照：

• 認証とセットアップ
• クエリとミューテーションの例
• タイムアウトハンドリングパターン
• MCP タイムアウト対応策
• シェルスクリプト互換性

クイックアドホッククエリ：

npx tsx ~/.claude/skills/linear/scripts/query.ts "query { viewer { name } }"

プロジェクト＆イニシアチブ

高度なプロジェクトとイニシアチブ管理パターンについては、projects.md を参照。

クイックリファレンス - 一般的なプロジェクトコマンド：

# イニシアチブにリンクされたプロジェクトを作成
npx tsx scripts/linear-ops.ts create-project "Phase X: 名前" "マイ・イニシアチブ"

# プロジェクトステータスを更新
npx tsx scripts/linear-ops.ts project-status "Phase X" in-progress
npx tsx scripts/linear-ops.ts project-status "Phase X" completed

# プロジェクトをイニシアチブにリンク/アンリンク
npx tsx scripts/linear-ops.ts link-initiative "Phase X" "マイ・イニシアチブ"
npx tsx scripts/linear-ops.ts unlink-initiative "Phase X" "古いイニシアチブ"

projects.md の重要なトピック：

• プロジェクト作成チェックリスト（必須ステップ）
• コンテンツフィールドと説明フィールド
• 作成前の発見
• 作業前のコードベース検証
• サブ課題管理
• プロジェクトステータス更新
• プロジェクト更新（ステータスレポート）

---

このスキルを使用する時期

Linear の課題、プロジェクト、チームを管理します

Linear の課題、プロジェクト、チームを管理する場合にこのスキルを使用します。

同期パターン（バルク操作）

コード変更を Linear に一括同期する場合は、sync.md を参照。

クイック同期コマンド：

# 課題を一括で完了に更新
npx tsx scripts/linear-ops.ts status Done ENG-101 ENG-102 ENG-103

# プロジェクトステータスを更新
npx tsx scripts/linear-ops.ts project-status "マイ・プロジェクト" completed

---

リファレンス

ドキュメント	目的
api.md	GraphQL API リファレンス、タイムアウト処理
sdk.md	SDK オートメーションパターン
sync.md	バルク同期パターン
projects.md	プロジェクト＆イニシアチブ管理
troubleshooting.md	一般的な問題、MCP デバッグ
docs/labels.md	ラベル分類

外部：Linear MCP ドキュメント

---

<!-- AGI-INTEGRATION-START -->

AGI フレームワーク統合

@techwavedev/agi-agent-kit に対応 元のソース：antigravity-awesome-skills

メモリファースト プロトコル

ワークフロー設定とオートメーションパターンをキャッシュ。以前のパイプラインデザインを取得して、同じようなフローを一から再構築することを避けます。

# 開始前に以前のワークフロー/オートメーションコンテキストを確認
python3 execution/memory_manager.py auto --query "Linear Claude Skill のオートメーションパターンとワークフロー設定"

結果を保存

作業完了後、ワークフロー/オートメーションの決定を今後のセッション用に保存：

python3 execution/memory_manager.py store \
  --content "ワークフロー：再試行ロジック、デッドレターキュー、失敗時の Slack アラート付きの自動化データパイプライン" \
  --type technical --project <project> \
  --tags linear-claude-skill workflow

マルチエージェント コラボレーション

ワークフロー状態を他のエージェントと共有して、オートメーションをトリガー、監視、または拡張できるようにします。

python3 execution/cross_agent_context.py store \
  --agent "<your-agent>" \
  --action "ワークフローオートメーションをデプロイ — パイプラインは 1 日あたり 1000 以上のイベントを処理し、99.9% の成功率" \
  --project <project>

プレイブック エンジン

このスキルを他のスキルと組み合わせて、プレイブック エンジン（execution/workflow_engine.py）を使用して、進捗追跡を含むガイド付きマルチステップオートメーションを実行します。

<!-- AGI-INTEGRATION-END -->