octocat

使用時機

このスキルを使用する対象:

• github.com URL が含まれるプロンプト（「GitHub」「issue」「PR」「repo」などのキーワードがない場合でも）
• issue、pull request、commit、compare ページ、Actions run、release、discussion、またはリポジトリへの GitHub リンク
• 「Fix https://github.com/owner/repo/issues/123」というスタイルのタスク
• pull request と GitHub issue の作成、レビュー、管理
• マージコンフリクト解決と履歴の書き換え
• pre-commit フック のデバッグと修正
• ブランチ管理とクリーンアップ
• GitHub Actions ワークフロー最適化
• あらゆる git コマンドまたは GitHub ワークフロー関連の質問

指示

起動時に:

1. プロンプトに GitHub URL が含まれている場合、その URL だけで起動を判断し、gh/git で即座に検査する
2. git/GitHub の状況をすぐに評価する
3. プロンプトに github.com URL が含まれている場合、直ちにこのスキルを起動し、その URL を関連する gh/git ワークフローに変換する
4. すべての GitHub 操作に gh CLI を使用する（Web インターフェースは提案しない）
5. 複雑な git 操作を正確に処理する
6. pre-commit フック の問題を修正するか、TypeScript linting は typescript-magician に委譲する
7. git の署名鍵設定を変更しない。署名がすでに有効で設定されている場合は使用する。それ以外の場合は、署名なしで進める
8. 「Co-Authored-By: Claude」のような AI 帰属を決して含めない

起動例

• Fix https://github.com/mercurius-js/mercurius/issues/1227
• Review https://github.com/nodejs/node/pull/12345
• What changed in https://github.com/org/repo/compare/v1.0.0...v1.1.0?
• Check https://github.com/org/repo/actions/runs/123456789
• Investigate https://github.com/org/repo/commit/abcdef1234567890

機能

高度な git 操作:

• インタラクティブリベース（コミット分割、squash）による履歴クリーニング
• cherry-pick、bisect、worktrees
• 高度なマージ戦略
• submodule と subtree の管理
• git フック の設定と保守
• git log/blame/show による リポジトリ考古学

gh CLI による GitHub 操作:

• 適切なテンプレートを使用した PR の作成・管理
• 明確な base/head と簡潔なコンテンツで PR を開く。例: gh pr create --base main --head <branch> --title "<title>" --body-file <file>
• PR をオープンした後、gh pr checks <num> --watch 2>&1 で CI を待機し、障害に対して積極的に対応する
• 未知の gh コマンドを使用する前に gh help <command> で検証する
• issue とプロジェクトボードの処理
• リリースと成果物の管理
• リポジトリ設定の設定
• ワークフロー と通知の自動化

PR本文フォーマット

gh pr create で PR を作成するときは、--body フラグの改行エスケープの問題を避けるため --body-file を使用する。

PR の説明をシンプルに保つ:

• プレーンテキストで変更の短い説明を記述する
• ## Summary や ## Testing などのサブセクションや見出しを追加しない
• テストセクションを含めない
• アーキテクチャ変更の場合は、追加のコンテキストが必要であれば、やや長めの説明が必要な場合がある

cat > /tmp/pr-body.md << 'EOF'
Refactor plugin loading so skills are discovered from the registry instead of being hardcoded.
EOF
gh pr create --body-file /tmp/pr-body.md

一時ファイルを使用する方がより清潔で、信頼性が高く、デバッグが容易である。

複雑な操作の検証チェックポイント

インタラクティブリベース: git rebase -i <base> → git log --oneline -n 10 で検証 → コンフリクト時: 解決、git add <file>、git rebase --continue → 任意の時点で git rebase --abort で中止

マージコンフリクト解決: git status（コンフリクト検出） → git diff で検査またはファイルを開く → すべてのマーカーを解決 → git add <resolved-file> → git merge --continue（または git rebase --continue） → git status でクリーンな状態を確認

ブランチクリーンアップ: git branch --merged main → git branch -d <branch> → git push origin --delete <branch> → git fetch --prune

コミット署名と帰属ルール

• git の署名鍵設定（user.signingkey）または署名モードをユーザー/リポジトリ設定で変更してはいけない
• コミット署名がすでに有効で正しく設定されている場合、既存のセットアップを使用して署名されたコミットを作成する
• 署名が有効でない/設定されていない場合、署名を強制したり設定したりしない。署名なしで進める
• 「Co-Authored-By: Claude」のような AI 共著帰属を決して追加しない