mcpField
F
fetch-issues

fetch-issues

github.com/ismail9k開発3051 回インストール1 週間前に更新
リポジトリ

fetch-issues について

Fetch Issues は、設定済みの課題トラッカーから未解決課題を取得して提示する読み取り専用スキルです。対象の特定、バックエンド確認、全件取得、結果報告を行い、課題は変更しません。

主な機能

  1. 01ユーザー入力または設定からトラッカーと対象を特定
  2. 02バックエンドの利用可否と認証を確認
  3. 03明示した上限で未解決課題を取得
  4. 04課題本文を省略せず結果範囲を明示
  5. 05トラッカー上の課題を変更しない

活用シーン

  1. 01リポジトリの GitHub 未解決課題を一覧化
  2. 02ローカル Markdown の未解決課題を読む
  3. 03設定済みトラッカーバックエンドの結果を報告
  4. 04ページングや上限による取得漏れを特定

インストール

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

$npx skills add https://github.com/ismail9k/skills --skill fetch-issues

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

詳細

イシューの取得

この手順を使う場合

ユーザーがトラッカーのオープンイシューを確認したい場合に使います。イシューを変更せず、トラッカーが返した内容を報告します。

既知のイシューを1件だけ確認する場合は、リスト全体を取得するのではなく、そのイシューだけを読み取ります。GitHub の場合は gh issue view <number> を実行します。

前提条件

  1. 何かを取得する前に、トラッカーと対象を特定します。
    • ユーザーが今回の実行でリポジトリまたはプロジェクトを明示している場合は、それを使います。
    • それ以外の場合は、docs/agents/issue-tracker.md の Backend、Location、Reading の各セクションを読み取ります。
    • 設定ファイルがない場合、対象が特定されていない場合、または曖昧な場合は、ユーザーに確認します。ディレクトリ名から推測したり、Git リモートを黙って代用したりしないでください。
  2. バックエンドに接続できることを確認します。
    • GitHub： command -v gh を実行します。見つからない場合は、https://cli.github.com/ を案内して終了します。次に gh auth status を実行します。失敗した場合は、役立つエラー部分を残し、gh auth login を実行するようユーザーに伝えて終了します。
    • ローカルの Markdown： 記録された Location が存在することを確認します。
    • その他のバックエンド： Reading セクションの「List open issues」に記載された方法を使います。設定に Reading セクションがない場合は、推測せずにイシューの一覧表示方法をユーザーに確認します。記録されたツールを利用できない場合（CLI がインストールされていない、MCP サーバーが接続されていないなど）は、その旨を伝えて終了します。

イシューを取得する

GitHub。 完全なレポートに必要なフィールドを要求し、明示的な上限を設定します。GitHub CLI の小さなデフォルト値によってオープンイシューが暗黙に省かれないようにしてください。

gh issue list \
  --repo <owner>/<repo> \
  --state open \
  --limit 1000 \
  --json number,title,body,labels,author,createdAt,url

コマンドがちょうど1,000件のイシューを返した場合は、結果が指定した上限に達した可能性があると伝えます。結果が完全だと断言せず、ページネーションを使った GitHub API リクエストで続きを取得することを提案します。

ローカルの Markdown。 Reading セクションでオープンとみなされるすべての intent ファイルを、全文読み取ります。

その他のバックエンド。 記録された方法を実行し、本文全体を要求します。ツールの結果にページ分割や上限がある場合は、完全だと断言せず、結果がどこで途切れたかを伝えます。

すべてのバックエンドで、ユーザーが要求しない限り、ラベル、担当者、マイルストーン、検索、作成者によるフィルターを追加しないでください。取得に失敗した場合は、エラーを報告して終了します。認証、認可、ネットワーク、対象の欠落による失敗を、空の結果として扱わないでください。

結果を提示する

オープンイシューがない場合は、その旨を伝え、確認したトラッカーと対象の名前を示します。

それ以外の場合は、返された合計件数を報告し、次の形式ですべてのイシューを表示します。<reference> はトラッカー独自の形式です。GitHub では #<number>、Jira では PROJ-123 のようなキー、ローカルの Markdown ではファイルパスです。

## <reference> — <title>

- URL: <url or file path>
- Labels: <comma-separated labels, or None>
- Author: <login or name, or Unknown>
- Created: <creation time in an unambiguous date format, or Unknown>

### Body

<complete body, or _No body provided._>

各イシューの本文は完全な状態にしてください。ユーザーが明示的に要約を求めない限り、黙って切り詰めたり、省略記号に置き換えたり、要約したりしないでください。完全な結果が1回の応答に収まらない場合は、イシューとイシューの間でのみ中断し、返されたイシューのうち何件を表示したかを伝え、次の応答で次のイシューから続けます。

してはいけないこと

  • ユーザーもトラッカー設定もトラッカーや対象を特定していない場合、推測しないでください。
  • GitHub 以外のバックエンドに GitHub のコマンドを適用したり、Reading セクションがないトラッカーのコマンドをでっち上げたりしないでください。
  • ツールのデフォルトのページサイズや上限に頼り、それを完全な結果として扱わないでください。
  • ユーザーの依頼がない限り、イシューの本文を省略、短縮、言い換えしないでください。
  • コマンドの失敗を隠して、オープンイシューがないと報告しないでください。
  • イシューを作成、編集、クローズ、ラベル付け、割り当て、その他の方法で変更しないでください。このスキルは読み取り専用です。

コメント

Markdown 対応