mcpField
T
trackers

trackers

github.com/gabriel-lafrance開発069 回インストール1 日前に更新
リポジトリ

trackers について

MCP または gh を使って課題やプルリクエストの情報を読み取る、読み取り専用のワーカー向けスキルです。受け入れ条件や制約を親の実行コンテキスト向けに要約します。

主な機能

  1. 01課題とプルリクエストの読み取り
  2. 02関連コメントや QA メモの取得
  3. 03受け入れ条件と制約の保持
  4. 04簡潔なチケットブリーフの作成

活用シーン

  1. 01チケット実装前の情報収集
  2. 02親タスク向けの課題要件の要約

MCP 対応

MCP と gh で課題やプルリクエストを読み取ります。チケットの作成、更新、コメント、クローズは行いません。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/gabriel-lafrance/skills --skill trackers

インストール後、Claude Code で/trackersを入力して読み込まれたか確認します。

詳細

トラッカー

必読: ../pack-shared/standards.md。このターンでは AGENTS.md の Taste と Architecture のセクションを適用し、チケットの受け入れ条件と制約を漏らさないでください。省略しないでください。

質問のスタイル: ../pack-shared/asking.md

このスキルは /task または /just-do-it のための作業ステップであり、通常のユーザー起点ではありません。

このパックは MCP と gh を介してトラッカーを参照します。簡潔なチケット概要を親のインライン実行コンテキストに返してください。エージェント所有の状態には保存しないでください。Cursor Cloud Agent との連携は別です。

チケットの Taste/Architecture に関する受け入れ条件と制約を概要に残してください。省略しないでください。

厳守事項:読み取り専用

許可: 理解のための課題、PR、コメント、ステータスの取得/一覧表示/閲覧、説明内のチェックリスト、関連する QA メモの確認。

禁止(絶対に行わない):

  • ステータス/状態の変更(「In Progress」、Done、クローズ)
  • コメント、返信、解決メモ
  • save_issue / update_issue /作成/割り当て
  • gh issue comment、gh issue close、gh pr comment(書き込み)、または変更を伴う API
  • ACHIEVED の後にクローズまたは「クローズ処理」を行うこと

チケットをクローズするのはユーザーの役割です(手動または PR のマージ)。このスキルは読み取りのみです。

トラッカーの判別

入力トラッカー
IN-1234、ENG-99、TEAM-123(英字と数字)Linear
linear.app/.../issue/... URLLinear
#123、owner/repo#123、github.com/.../issues/123GitHub
数字のみで曖昧な場合1 回だけ質問します:Linear と GitHub のどちらですか?

呼び出し元が複数の関連チケットを明示的に指定しない限り、範囲を限定した実行コンテキストごとにチケット ID は 1 つです。

先にツールを確認する

何かを呼び出す前に:

  1. linear|github のパターンで GetMcpTools を実行します(または Linear/GitHub サーバーを直接確認します)。
  2. 実際のツールスキーマを読みます。読み取りツール(get_issue、list_comments、get_pull_request など)を優先します。書き込みツールは無視します。
  3. サーバーが needsAuth の場合は、mcp_auth を 1 回実行してからツールを再確認します。

取得する

Linear

次の条件に一致する MCP 読み取りツールを優先します:get_issue、list_comments、list_issue_statuses(実際の名前はツールの確認時に取得します。ステータスは概要のラベル付けに使い、書き込みには使いません)。

識別子は指定されたとおりに渡します(IN-1234)。次の情報を取得します:

  • タイトル、説明、ステータス、優先度、ラベル、担当者
  • 説明内の受け入れ条件/QA チェックリスト
  • 制約を追加するコメント(単なる雑談は無視)
  • 関連する PR/Git ブランチがあれば、その PR のタイトル、本文、レビューコメントも取得します(可能な場合。読み取りのみ)。
GitHub

GitHub MCP の読み取りツールがあれば優先します。ない場合は gh の閲覧/一覧表示のみを使います:

gh issue view <N> --json number,title,body,labels,assignees,state,url,comments
# or
gh issue view owner/repo#N --json number,title,body,labels,assignees,state,url,comments

gh pr view <N> --json number,title,body,url,comments,reviews,commits

gh がない、または認証されていない場合は、その旨を伝えて停止してください。チケット/PR の本文を捏造しないでください。

チケット概要にまとめる

# Ticket
- **ID:** IN-1234
- **Tracker:** Linear | GitHub
- **URL:** …
- **Title:** …

# Ask
<what the ticket wants, user perspective>

# Acceptance / QA (from ticket)
1. …
2. …

# Constraints
- …

# Out of scope
- … (explicit non-goals from ticket or comments)

# Linked PR (if any)
- **URL:** …
- **Summary:** …
- **Review notes worth keeping:** …

# Source
<ticket or PR URL only — do not paste the full body into every later prompt>

受け入れ条件がない場合は、1 つ質問するか、Ask から二値の Done 条件を導き、承認用に提示してください。トラッカーには書き戻さないでください。

呼び出し元による概要の使い方

  • 親の概要、受け入れを示す証拠、/code-review の仕様ソース
  • チケット/PR の参照先と関連する受け入れ条件をチャットに残します。親がそれらを Git とリポジトリの証拠と組み合わせます。
  • ワークスペース、ステータス、計画、登録情報、トラッカーの更新は作成しないでください。

失敗時

問題対応
Linear MCP がないユーザーに Cursor MCP tools から Linear(https://mcp.linear.app/mcp)を追加してから、再試行するよう伝えます。チケットを捏造しないでください。
gh がない/ログインしていないgh をインストール/認証するか、課題の本文を一度貼り付けるよう依頼します。
チケット/PR が見つからない停止し、ID/チーム/リポジトリを確認します。

アンチパターン

  • このスキルだけを「チケットを更新して」と呼び出す
  • ID だけからタイトル/受け入れ条件を捏造する
  • Linear または GitHub に書き込む/クローズする/コメントする
  • すべてのスキルターンでチケット本文全体を貼り付ける(概要にとどめ、参照先を記載する)
  • このチャットでの取得の代わりに、Cloud Agent の Linear 割り当てを使う

コメント