GitHub Operations

Overview

このスキルは、gh CLI ツールと GitHub REST/GraphQL API を使用した GitHub 操作に関する包括的なガイダンスを提供します。プルリクエスト管理、issue トラッキング、リポジトリ操作、ワークフロー自動化、API インタラクションを含む GitHub 関連のタスクを実行する際にこのスキルを使用してください。

When to Use This Skill

このスキルは以下のタスクでアクティベートされます:

• プルリクエストの作成、表示、編集、またはマージ
• GitHub issue またはリポジトリ設定の管理
• GitHub API エンドポイント(REST または GraphQL)のクエリ
• GitHub Actions ワークフローの操作
• リポジトリの一括操作
• GitHub Enterprise との統合
• CLI または API 経由での GitHub 操作の自動化

Core Operations

Pull Requests

# Create PR with NOJIRA prefix (bypasses JIRA enforcement checks)
gh pr create --title "NOJIRA: Your PR title" --body "PR description"

# List and view PRs
gh pr list --state open
gh pr view 123

# Manage PRs
gh pr merge 123 --squash
gh pr review 123 --approve
gh pr comment 123 --body "LGTM"

📚 包括的な PR ワークフローについては references/pr_operations.md を参照してください

PR タイトル規約:

• JIRA チケット付き: GR-1234: Descriptive title
• JIRA チケットなし: NOJIRA: Descriptive title

Issues

# Create and manage issues
gh issue create --title "Bug: Issue title" --body "Issue description"
gh issue list --state open --label bug
gh issue edit 456 --add-label "priority-high"
gh issue close 456

📚 詳細な issue 管理については references/issue_operations.md を参照してください

Repositories

# View and manage repos
gh repo view --web
gh repo clone owner/repo
gh repo create my-new-repo --public

Workflows

# Manage GitHub Actions
gh workflow list
gh workflow run workflow-name
gh run watch run-id
gh run download run-id

📚 高度なワークフロー操作については references/workflow_operations.md を参照してください

GitHub API

gh api コマンドは GitHub REST API エンドポイントへのダイレクトアクセスを提供します。包括的な API エンドポイント ドキュメントについては references/api_reference.md を参照してください。

基本的な API 操作:

# Get PR details via API
gh api repos/{owner}/{repo}/pulls/{pr_number}

# Add PR comment
gh api repos/{owner}/{repo}/issues/{pr_number}/comments \
  -f body="Comment text"

# List workflow runs
gh api repos/{owner}/{repo}/actions/runs

複数の関連リソースを必要とする複雑なクエリについては GraphQL を使用してください。GraphQL の例については references/api_reference.md を参照してください。

Authentication and Configuration

# Login to GitHub
gh auth login

# Login to GitHub Enterprise
gh auth login --hostname github.enterprise.com

# Check authentication status
gh auth status

# Set default repository
gh repo set-default owner/repo

# Configure gh settings
gh config set editor vim
gh config set git_protocol ssh
gh config list

Output Formats

プログラム処理の出力形式を制御します:

# JSON output
gh pr list --json number,title,state,author

# JSON with jq processing
gh pr list --json number,title | jq '.[] | select(.title | contains("bug"))'

# Template output
gh pr list --template '{{range .}}{{.number}}: {{.title}}{{"\n"}}{{end}}'

📚 シェル パターンと自動化戦略については references/best_practices.md を参照してください

Quick Reference

最も一般的な操作:

gh pr create --title "NOJIRA: Title" --body "Description"  # Create PR
gh pr list                                                  # List PRs
gh pr view 123                                              # View PR details
gh pr checks 123                                            # Check PR status
gh pr merge 123 --squash                                    # Merge PR
gh pr comment 123 --body "LGTM"                            # Comment on PR
gh issue create --title "Title" --body "Description"       # Create issue
gh workflow run workflow-name                               # Run workflow
gh repo view --web                                          # Open repo in browser
gh api repos/{owner}/{repo}/pulls/{pr_number}              # Direct API call

Resources

references/pr_operations.md

以下を含む包括的なプルリクエスト操作:

• 詳細な PR 作成パターン(JIRA 統合、ファイルからのボディ、ターゲット ブランチ)
• 表示とフィルタリング戦略
• レビュー ワークフローと承認パターン
• PR ライフサイクル管理
• 一括操作と自動化の例

複雑な PR ワークフローまたは一括操作を扱う際にこのリファレンスを読み込んでください。

references/issue_operations.md

以下を含む詳細な issue 管理の例:

• ラベルと担当者を含む issue 作成
• 高度なフィルタリングと検索
• issue ライフサイクルと状態管理
• 複数の issue に対する一括操作
• PR とプロジェクトとの統合

大規模な issue 管理またはワークフロー設定を行う際にこのリファレンスを読み込んでください。

references/workflow_operations.md

以下を含む高度な GitHub Actions ワークフロー操作:

• ワークフロー トリガーと手動実行
• 実行監視とデバッグ
• アーティファクト管理
• シークレットと変数
• パフォーマンス最適化戦略

CI/CD ワークフローを操作するか失敗した実行をデバッグする際にこのリファレンスを読み込んでください。

references/best_practices.md

以下を含むシェル スクリプト パターンと自動化戦略:

• 出力フォーマッティング(JSON、テンプレート、jq)
• ページネーションと大量結果セット
• エラー処理と再試行ロジック
• 一括操作と並列実行
• エンタープライズ GitHub パターン
• パフォーマンス最適化

自動化スクリプトを構築するかエンタープライズ デプロイメントを処理する際にこのリファレンスを読み込んでください。

references/api_reference.md

以下を含む包括的な GitHub REST API エンドポイント ドキュメント:

• 例付きの完全な API エンドポイント リファレンス
• リクエスト/レスポンス形式
• 認証パターン
• レート制限ガイダンス
• Webhook 設定
• 高度な GraphQL クエリ パターン

複雑な API 操作を実行する場合または詳細なエンドポイント仕様が必要な場合にこのリファレンスを読み込んでください。