linear-setup について
プロジェクトの目標、リポジトリの履歴、ロードマップを基に Linear の追跡を始めるためのガイドスキルです。書き込み前の既存情報確認と、エージェント指示への追跡ルールの追加を重視します。
主な機能
- 01Linear MCP のアクセスを事前確認
- 02変更前に既存の追跡内容を確認
- 03マイルストーンと課題の構成
- 04リポジトリの証拠に基づく作業の遡及登録
- 05エージェント指示への追跡ルール追加
活用シーン
- 01リポジトリを基に Linear プロジェクトを作成
- 02既存の追跡内容を慎重に拡張
- 03変更履歴や git 履歴から完了作業を登録
MCP 対応
変更前に Linear MCP のアクセスを確認し、失敗した場合は停止します。Linear を使ってプロジェクトの追跡を設定・維持します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ tjcages/ linear --skill linear-setupインストール後、Claude Code で/linear-setupを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
ALWAYS_ON.mdAUTH.mdAUTOMATION.mdEXAMPLES.mdMETHODOLOGY.mdRESPONSE.md詳細
Linear のセットアップ
チャットのルール:RESPONSE.md。認証:AUTH.md。詳細な手法:METHODOLOGY.md。
ステップ 0 — 認証
Linear MCP を確認します。失敗した場合 → このエージェント向けの AUTH.md の手順に従い、停止します。API 呼び出しを捏造してはいけません。
作業の順序
順番どおりに進めます。早い段階にゲートがあるのは、手順を誤ると稼働中のワークフローを損なうためです。
1. すでに追跡されていますか?(§1a)
リポジトリ名で Linear を検索し、さらにユーザーに確認します。何もない状態だと決めつけてはいけません。
- 何もない → 新規に初期設定し、続行します。
- 存在する → 停止します。課題/マイルストーン/ラベル/ドキュメント/ステータス更新を列挙 → 要約 → 書き込みの前にカテゴリごとに「はい/いいえ」を確認します。慎重に拡張します。リポジトリをスキャンし、同期されていないロードマップのドキュメントを探します(§4.7)。
2. 北極星(§1b)
README をビジョンとして扱えば、通常は十分です。判断を明確に述べてください。質問 5(なぜ追跡するのか?)によって形が決まります。METHODOLOGY の「目標→形」表を参照してください。
3~4. 種類+構造(§2~§3)
推奨される種類:Product / Tool / Drop / Marketing。マイルストーンは実際のフェーズと 1 対 1 に対応させます。エンジニアリング/ローンチ/展開のトラックを分けます。日付は実際の根拠がある場合に限ります。形が不明確な場合は、§17 を優先してください。
5. 遡及入力(§4)
CHANGELOG > ロードマップ > git log。既定では機能単位、リリース済みパッケージはリリース単位にします。完了とするには証拠が必要です。ドキュメント上の「完了」は証明になりません。裏付けを確認してください(§4.8)。
チケットの記述
タイトルは 8 語以内。説明は 3 文以内、または箇条書き 5 項目以内。コメントは 3 行以内。文章よりスクリーンショットを優先します(§10)。
6. 接続(§4、§10、§11)
実際の blockedBy/blocks を設定します。UI のみの項目は早い段階で明示します(§11)。README を Linear のプロジェクトドキュメントとして追加します。
7. インストールの規律(§5)
追跡プロトコルを、常時読み込まれるエージェントの指示ファイル(CLAUDE.md / AGENTS.md / .cursor/rules/)に、実際のチーム名/プロジェクト名/マイルストーン名を使って記述します。これが済むまで初期設定は完了ではありません。
8. 誠実さ(§6、§9)
ステータス更新は、マイルストーンや健全性を確認するタイミングに限ります。日付が遅れる前に atRisk を設定します。
9. 完了チェック(§18、§26)
重要な項目に 0 がなく、評価基準が 16/20 以上であること。そうでない場合は、§26 の監査をすべて実施します。
セットアップ後
常時有効な設定がない場合は、ユーザーに finish linear-tracking install を案内します。任意の Cursor の週次健全性チェック:AUTOMATION.md。次のアクションは 1 つだけ提示します。