mcpField
L
linear-setup

linear-setup

github.com/tjcages開発1039 回インストール13 週間前に更新
リポジトリ

linear-setup について

プロジェクトの目標、リポジトリの履歴、ロードマップを基に Linear の追跡を始めるためのガイドスキルです。書き込み前の既存情報確認と、エージェント指示への追跡ルールの追加を重視します。

主な機能

  1. 01Linear MCP のアクセスを事前確認
  2. 02変更前に既存の追跡内容を確認
  3. 03マイルストーンと課題の構成
  4. 04リポジトリの証拠に基づく作業の遡及登録
  5. 05エージェント指示への追跡ルール追加

活用シーン

  1. 01リポジトリを基に Linear プロジェクトを作成
  2. 02既存の追跡内容を慎重に拡張
  3. 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.md
AUTH.md
AUTOMATION.md
EXAMPLES.md
METHODOLOGY.md
RESPONSE.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 つだけ提示します。

コメント