Linear プロジェクトトラッカー

## 誰向けか

スプリント、課題、マイルストーンの管理に Linear を使用している開発者とプロジェクトリーダー向けです。このプラグインを使用すると、Linear アプリを開くことなく、チャットメッセージからチケット作成、プロジェクトマイルストーンの更新、一括自動化の実行、チームワークフローの追跡が可能になります。

## 3 ステップクイックスタート

1. **課題を作成** — 以下のように指示：`"Use 0xsero-linear to create a bug ticket in project Mobile App: 'Login button unresponsive on iOS 17', priority High, assign to @alice"`。スキルが Linear GraphQL API を呼び出し、新しい課題 ID と URL を返します。
2. **マイルストーンを更新** — 以下のように指示：`"Use bind-linear-milestones-write to add a milestone 'Beta Release v2.0' to project Mobile App, due 2026-03-31"`。マイルストーン ID を含む確認メッセージが返されます。
3. **一括更新を自動化** — 以下のように指示：`"Use sickn33-linear-automation to move all issues labeled 'blocked' in the current cycle to the next cycle"`。Composio Linear ツールキットを介して自動化が実行され、移動された課題数が報告されます。

## ステップ → スキル → 入力 → 出力

| ステップ | スキル | 必要な情報 | 結果 |
|------|-------|------------------|--------------|
| 課題の作成・更新 | 0xsero-linear | プロジェクト名 + 課題詳細 | 課題 URL + ID |
| CLI 課題管理 | 0xbigboss-linear | チーム/プロジェクト + アクション | 課題リストまたはアクション確認 |
| チケットの読み取り・書き込み | davila7-linear | チケット ID または検索クエリ | チケット詳細または更新済みチケット |
| マイルストーン作成 | bind-linear-milestones-write | プロジェクト + マイルストーン名 + 期限 | マイルストーン ID + 確認 |
| 一括自動化 | sickn33-linear-automation | フィルタ条件 + アクション | 更新された課題数 |

## 一般的な問題と解決策

- **0xsero-linear が「プロジェクトが見つかりません」を返す** → Linear ではプロジェクト名は大文字・小文字が区別されます。Linear ワークスペースのサイドバーから正確な名前をコピーしてください。
- **bind-linear-milestones-write が「権限がありません」で失敗する** → マイルストーンには編集者権限が必要です。Linear API キーに書き込み権限があるか確認してください。
- **sickn33-linear-automation が 0 件の課題を移動する** → フィルタが既存の課題と一致するか確認してください。最初にシンプルなクエリを試してください：`"list all blocked issues in current cycle"`。

## 成功基準

以下の場合、正常に動作しています：
- 0xsero-linear または davila7-linear が、作成・更新された課題への `linear.app` リンクを返す
- bind-linear-milestones-write が ID でマイルストーンを確認する
- sickn33-linear-automation が処理された課題数を報告する（0 でも問題ありません — フィルタが一致しなかったことを意味し、失敗ではありません）