mcpField
G
github

github

github.com/johnlindquist開発2638 回インストール45 週間前に更新
リポジトリ

github について

github は、`gh` コマンドラインで GitHub の Issue を管理するスキルです。作成、絞り込み、閲覧、編集、担当者の割り当て、クローズに対応し、操作前に該当する手順書を読むよう定めています。

主な機能

  1. 01会話の内容から Issue を作成
  2. 02Issue の一覧表示と絞り込み
  3. 03詳細とコメントの確認
  4. 04タイトル、本文、ラベル、担当者の編集
  5. 05担当者の割り当てとクローズ

活用シーン

  1. 01報告されたバグを Issue 化
  2. 02状態やラベルで未解決 Issue を分類
  3. 03スプリント計画で Issue を割り当て
  4. 04コメントを添えて解決済み Issue をクローズ

インストール

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

$npx skills add https://github.com/johnlindquist/claude --skill github

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

ASSIGN_ISSUE.md
CLOSE_ISSUE.md
CREATE_ISSUE.md
LIST_ISSUES.md
UPDATE_ISSUE.md
VIEW_ISSUE.md

詳細

GitHub Issues Manager

gh CLI ツールを使用した GitHub Issue の包括的な管理機能です。この Skill では、GitHub Issue の作成、表示、更新、管理を包括的に行えます。

機能

  1. Issue の作成 - 会話のコンテキストをもとに新しい GitHub Issue を作成します
  2. Issue の一覧表示 - 状態、ラベル、担当者で Issue を表示、絞り込みます
  3. Issue の表示 - コメントを含む Issue の詳細全体を表示します
  4. Issue の更新 - タイトル、本文、ラベル、担当者を変更します
  5. Issue のクローズ - 任意のクローズコメントを添えて Issue をクローズします
  6. Issue の割り当て - チームメンバーに Issue を割り当てます

クイックリファレンス

各操作の詳しい手順については、以下を参照してください。

よくあるワークフロー

バグ報告ワークフロー
  1. ユーザーが会話でバグを報告します
  2. /create-issue を使って Issue を作成するか、作成を依頼します
  3. 話し合いのコンテキストを含む Issue が作成されます
  4. 適切なチームメンバーに割り当てます
  5. ラベル（bug、priority など）を追加します
Issue のトリアージワークフロー
  1. フィルターを使ってオープン中の Issue を一覧表示します
  2. 詳細を確認するため、特定の Issue を表示します
  3. ラベルと担当者を更新します
  4. 解決済みの Issue をステータス更新とともにクローズします
スプリント計画ワークフロー
  1. ラベルまたはマイルストーンで Issue を一覧表示します
  2. チームメンバーに Issue を割り当てます
  3. 優先度と見積もりを更新します
  4. ステータス更新を通じて進捗を追跡します

重要な指示

必須：GitHub Issue に関する操作を実行する前に、関連するリファレンスファイルを Read ツールで必ず読み込んでください。これらのリファレンスには、この概要に含まれていない重要なコマンドパターン、パラメーター、ワークフローが記載されています。

ユーザーから GitHub Issue の操作を依頼された場合：

  1. 実行する操作（作成、一覧表示、表示、更新、クローズ、割り当て）を特定します
  2. 必須： コマンドを実行する前に、Read ツールを使って関連するリファレンスファイルを読み込みます。
    • Issue の作成 → 最初に CREATE_ISSUE.md を読み込みます
    • Issue の一覧表示 → 最初に LIST_ISSUES.md を読み込みます
    • Issue の表示 → 最初に VIEW_ISSUE.md を読み込みます
    • Issue の更新 → 最初に UPDATE_ISSUE.md を読み込みます
    • Issue のクローズ → 最初に CLOSE_ISSUE.md を読み込みます
    • Issue の割り当て → 最初に ASSIGN_ISSUE.md を読み込みます
  3. 読み込んだリファレンスの正確なパターンに従って、gh CLI コマンドを実行します
  4. Markdown の競合を避けるため、Issue の本文には一時ファイルを使用します（リファレンスの指定に従ってください）
  5. 操作を確認し、結果を表示します

関連するリファレンスドキュメントを最初に読み込まずに、GitHub Issue のコマンドを実行しないでください。

ベストプラクティス

  • シェルのエスケープに関する問題を避けるため、Issue の本文には常に --body-file を使用します
  • 競合を避けるため、一時ファイル名には $$ を使用します（プロセス ID に展開されます）
  • 適切な Markdown 構造で Issue の本文を整形します
  • Issue の作成時には、会話のコンテキストを含めます
  • 操作後に一時ファイルを削除します
  • ユーザーが GitHub に移動できるよう、Issue の URL を表示します

例

コンテキストから Issue を作成する
User: "I found a bug where login fails with special characters"
Me: *Creates issue with details from conversation*
Issue を一覧表示して絞り込む
User: "Show me all open bugs assigned to alice"
Me: gh issue list --state open --label bug --assignee alice
Issue を更新する
User: "Add high-priority label to issue #123"
Me: gh issue edit 123 --add-label "high-priority"
コンテキストを添えてクローズする
User: "Close issue #456, it was fixed in the last PR"
Me: gh issue close 456 --comment "Fixed in PR #789"

コメント

Markdown 対応