Linear Cowork

バイブコーディングチーム向けの標準化されたLinearコラボレーションワークフロー。

MCP セットアップ

このスキルを使用する前に、Linear MCPサーバーがインストールされ、認証されていることを確認してください。

Claude Code向けのクイックセットアップ:

claude mcp add --transport http linear-server https://mcp.linear.app/mcp

Codex向けのクイックセットアップ:

codex mcp add linear --url https://mcp.linear.app/mcp

Cursorのセットアップと全ツール向けの詳細な手順については、このスキルディレクトリの setup-guide.md を参照してください。

イシュー命名規則

命名ルール

すべてのイシュータイトルは以下の形式に従う必要があります:

[Type] 短い説明

有効なタイプ:

タイプ	使用場面
[Feature]	新機能
[Bug]	バグ修正
[Chore]	メンテナンス、依存関係、設定
[Refactor]	動作変更のないコードの再構成
[Docs]	ドキュメント変更

良い例:

• [Feature] OAuth ログインフローの追加
• [Bug] 空のカート送信時のクラッシュを修正
• [Chore] React を v19 にアップグレード

悪い例(使用しないでください):

• ログインを追加 — タイププレフィックスがない
• [Feature] ログイン — 曖昧で説明不足
• Feature: ログイン追加 — 形式が間違い、角括弧を使う必要があります

説明テンプレート

すべてのイシュー説明には以下の2つのセクションが含まれる必要があります:

## Background
[このイシューが存在する理由。解決する問題。関連するコンテキスト。]

## Acceptance Criteria
- [ ] [具体的でテスト可能な条件]
- [ ] [別の条件]

Acceptance Criteriaをスキップしないでください。 小さなタスクであっても、少なくとも1つの条件が必要です。

ワークフロー規則

デフォルト割り当て

Linear MCPを介してイシューを作成する場合、ユーザーが異なる担当者を明示的に指定しない限り、常に現在認証されているユーザー(「me」)に割り当ててください。

イシューステータスライフサイクル

Linearのイシューには6つのステータスがあります。ユーザーの作業が進むにつれて、イシューステータスを積極的に更新してください:

ステータス	タイプ	使用場面
Backlog	backlog	未計画 — 収集したが未確定
Todo	unstarted	確定済みで作業開始準備完了
In Progress	started	積極的に作業中
Done	completed	作業完了で検証済み
Canceled	canceled	実施しない
Duplicate	canceled	別のイシューで既にカバー

ステータス遷移ルール:

Backlog → Todo → In Progress → Done
                              → Canceled
                              → Duplicate

• イシューを作成する: ユーザーが別途指定しない限り、Todoに設定(Backlogではない)
• ユーザーがイシューの作業を開始: In Progressに更新
• イシュー用のコードをコミット: Doneに更新
• ユーザーがキャンセル/スキップと言う: Canceledに更新
• ユーザーが重複を特定: Duplicateに更新

積極的なステータス更新: 文脈から明らかな場合(例:ユーザーが「ONE-42で作業中です」または「ONE-42を開始しましょう」と言う場合)、聞く必要なく、ステータスをIn Progressに更新してください。同様に、イシューにリンクされたコードをコミットするときは、自動的にDoneに更新してください。

ラベル

すべてのイシューにはラベルが必要です。イシュータイプに基づいて選択します:

ラベル	色	使用場面
Feature	紫	新機能([Feature] イシュー)
Bug	赤	バグ修正([Bug] イシュー)
Improvement	青	改善、リファクタリング、チョア、ドキュメント([Refactor], [Chore], [Docs] イシュー)

イシュータイプからラベルへのマッピング:

イシュータイプ	ラベル
[Feature]	Feature
[Bug]	Bug
[Chore]	Improvement
[Refactor]	Improvement
[Docs]	Improvement

イシュー作成時に自動的にラベルを適用してください — マッピングが曖昧でない限り、ユーザーに尋ねないでください。

優先度

すべてのイシューに優先度を設定する必要があります。ユーザーが別途指定しない限り、デフォルトはMedium(3)です。

値	レベル	使用場面
0	優先度なし	デフォルトとして使用しないでください
1	緊急	本番環境ダウン、データ損失、セキュリティ脆弱性
2	高	他の作業をブロック、主要なユーザー向けの問題
3	中	デフォルト — 標準的な機能作業、通常のバグ
4	低	便利な機能、軽微なポリッシュ、技術負債

サブエージェント戦略

コストと品質のバランスを取るため、異なるタスクに異なるモデルを使用します:

タスク	モデル	理由
Linearから読み込み(イシューをリスト、詳細を取得)	Haikuサブエージェント	安価で高速、繰り返し作業
Linearに書き込み(イシュー作成/更新、コメント)	Haikuサブエージェント	シンプルなAPI呼び出し
イシューコンテキストのコードベース探索	Exploreサブエージェント	効率的なファイル検索
イシューコンテンツ(タイトル、説明、条件)のドラフト作成	メインモデル	高品質な文章が必要

イシュー作成ワークフロー:

1. Haiku    → Linearから読み込み(既存イシュー、プロジェクト、チームコンテキストを確認)
2. Explore  → 必要に応じてコードベースを検索(イシューのコンテキストを理解)
3. Main     → イシュータイトル、説明、受け入れ基準をドラフト
4. Preview  → ユーザー確認用にドラフトを表示
5. Haiku    → ユーザー承認後、Linearに送信

イシュー更新ワークフロー:

1. Haiku    → Linearから現在のイシュー状態を読み込み
2. Main     → 必要な変更を判断(必要に応じてコードベースを探索)
3. Preview  → 変更内容をユーザーに確認(コンテンツ変更の場合)
4. Haiku    → Linearに更新を適用

重要なルール:

• 送信前に常にイシューコンテンツをプレビューしてください。 作成またはコンテンツ変更前に、ユーザーにフルタイトル、説明、ラベル、優先度、ステータスを表示してください。
• ステータスのみの更新(例:Todo → In Progress)はプレビューが不要です — 直接適用してください。
• シンプルな読み取りと書き込みはコンテキストトークンを節約するためHaikuを通じて行います。
• ユーザーが見るコンテンツ(タイトル、説明、条件)は品質のためメインモデルでドラフト作成する必要があります。

プロジェクト整理

• Linear Projectsを使用して、機能領域またはマイルストーン別に関連イシューをグループ化してください
• イシューを作成する前に、関連するプロジェクトが存在するかを確認してください
• 関連するプロジェクトが存在せず、3つ以上のイシューにまたがる場合は、まずプロジェクトを作成してください

コミット前チェックリスト

すべてのコミット前に、以下のフローに従ってください:

コミット予定?
  ├─ Linearイシューに関連?
  │   ├─ 不明 → ユーザーにイシューIDを尋ねる
  │   │   ├─ ユーザーが確認 → ステータスを完了に更新、コミットにIDを含める
  │   │   └─ イシューなし → 通常通りコミット
  │   ├─ はい、既知 → ステータスを完了に更新、コミットにIDを含める
  │   └─ いいえ → 通常通りコミット

ステップ:

1. コミット前に以下を尋ねます: 「このコミットはLinearイシューに関連していますか? そうであれば、どのイシュー(例:ONE-123)?」
2. ユーザーがイシューIDを提供する場合:
   • サブエージェントを使用してイシューステータスをDoneに更新
   • イシューIDをコミットメッセージに含めます。例:[ONE-123] Fix cart crash on empty submission
3. ユーザーが関連するイシューはないと言う場合、通常通りコミットを進めてください。

イシューIDを含むコミットメッセージ形式

[ISSUE-ID] commit message

# 例:
[ONE-42] Add OAuth login flow
[ONE-15] Fix crash on empty cart submission

クイックリファレンス

アクション	ルール
イシュータイトル	[Type] 短い説明
イシュー説明	Background + Acceptance Criteriaセクション
イシューを割り当て	ユーザーが別途指定しない限り、デフォルトは「me」
ラベル	イシュータイプに基づいて自動適用:Feature / Bug / Improvement
優先度	ユーザーが別途指定しない限り、デフォルトはMedium(3)
新規イシューステータス	デフォルトは「Todo」
作業を開始	「In Progress」に更新
イシューにリンクされたコミット	「Done」に更新
Linearの読み書き	Haikuサブエージェント
イシューコンテンツのドラフト	メインモデル、送信前にプレビュー
コミット前	イシューIDを確認、ステータスを完了に更新
コミットメッセージ	[ISSUE-ID] message
複数の関連イシュー	Projectでグループ化