github-repo-management について
github-repo-managementは、ローカルGitの作業とGitHubリポジトリのワークフローを扱うスキルです。リポジトリ設定、ブランチ、コミット、プルリクエストの手順に加え、認証情報や破壊的操作への注意点も示します。
主な機能
- 01ローカルGitコマンドの手順
- 02リポジトリの作成と設定
- 03ブランチとコミットのワークフロー
- 04GitHub MCP経由のプルリクエスト操作
- 05秘密情報と破壊的操作への対策
活用シーン
- 01リポジトリの作成と接続
- 02コミットの準備とプッシュ
- 03プルリクエストの作成や確認
MCP 対応
GitHubの操作には、リポジトリ管理やプルリクエストを含めGitHub MCPを使う手順です。ローカルリポジトリの作業にはローカルのGitコマンドを使います。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ fanthus/ agent-skills --skill github-repo-managementインストール後、Claude Code で/github-repo-managementを入力して読み込まれたか確認します。
詳細
GitHub リポジトリ管理
ルール
- シークレット:トークンやシークレットを出力、コマンド、ファイルの内容に含めたり、表示したり、ログに記録したりしないでください。認証は GitHub MCP が処理します。
- 破壊的な操作:
git push --force、git branch -D、リポジトリの削除、リモートの履歴の上書きを行う前に、確認を求めてください。 - デフォルトブランチ:
mainを優先してください。リポジトリですでにmasterが使われている場合に限り、masterを使用してください。 - コミット:Conventional Commits を使用してください(例:
feat:、fix:、docs:)。
機能
- git コマンドをローカルで実行します(init、add、commit、push、branch、checkout など)。
- GitHub での操作は GitHub MCP のみを使用します。リポジトリの作成、リポジトリ情報の取得、PR の一覧表示・作成・マージ、ブランチの管理を行います。REST API や GITHUB_TOKEN を直接使用しないでください。
リポジトリを作成する
ユーザーが「リポジトリを作成して」または「GitHub リポジトリを作成して」と依頼した場合:
-
GitHub 上に作成する(GitHub MCP のみを使用):
- GitHub MCP の
create_repository(または同等のもの)を使用し、name、任意のdescription、およびユーザーの意図に基づくデフォルト値のprivateを指定します。
- GitHub MCP の
-
ローカルで origin を設定する(すでに git リポジトリ内にいる場合):
git remote add origin https://github.com/<owner>/<repo>.gitoriginが存在し、新しいリポジトリを指すように変更する必要がある場合は、変更前に確認を求めてください。 -
ローカルリポジトリがまだない場合:
git init git remote add origin https://github.com/<owner>/<repo>.git -
最初の push(少なくとも1つのコミットの後):
git push -u origin mainGitHub リポジトリが別のデフォルトブランチで作成された場合を除き、
mainを使用してください。
コードを push する
ユーザーが「コードを push して」または「GitHub に push して」と依頼した場合:
- git リポジトリがあることを確認する:
git statusを実行します。リポジトリでない場合は、git initを実行してリモートを設定するかどうか尋ねてください。 - リモートを確認する:
git remote -vを実行します。originがない場合は、リポジトリの URL を尋ねるか、先にリポジトリを作成してください。 - 適切にコミットする:
- 変更を確認するために
git statusを実行します。 - ステージングします:
git add <paths>を実行するか、ユーザーがすべての変更を意図している場合はgit add -Aを実行します。 - Conventional Commits に従ったメッセージでコミットします:
git commit -m "type(scope): description"。 - 未コミットの変更があり、ユーザーが「push」と言った場合は、先にコミットするかどうかを提案します。確認なしに force push しないでください。
- 変更を確認するために
- push する:
git push origin <branch>を実行します。デフォルトブランチはmainです。upstream が設定されていない場合は、git push -u origin mainを実行します。
リポジトリ情報を取得する
ユーザーが「リポジトリ情報を取得して」、「リポジトリの詳細を教えて」、または「リポジトリを表示して」と依頼した場合:
- リポジトリを特定する:
git remote get-url origin(owner/repo)またはユーザーが指定した owner/name を使用します。 - GitHub MCP 経由で取得する:MCP ツールを使用してリポジトリの詳細を取得します(例:リポジトリの取得、ブランチ一覧の取得、PR 一覧の取得)。名前、説明、デフォルトブランチ、公開設定、取得可能な場合はスター数・フォーク数、クローン URL を要約します。
ブランチ
- ブランチを作成する:
git checkout -b <branch-name>を実行してから、git push -u origin <branch-name>で push します。 - ブランチを切り替える:
git checkout <branch>またはgit switch <branch>を実行します。 - ブランチを削除する:ローカルでは
git branch -d <branch>を実行します。リモートブランチの削除は、ユーザーの確認後にのみgit push origin --delete <branch>を実行してください。
プルリクエスト
- PR を作成する:GitHub MCP を使用してプルリクエストを作成します(
head、デフォルトがmainのbase、title、body)。 - PR を一覧表示する:GitHub MCP を使用して PR を一覧表示し、番号、タイトル、状態、作成者ごとに要約します。
- マージする:GitHub MCP を使用してマージします。マージする前にユーザーに確認してください。
Conventional Commits のコミットメッセージ
次の形式を使用します:type(scope): short description。
| Type | 用途 |
|---|---|
feat | 新機能 |
fix | バグ修正 |
docs | ドキュメントのみ |
style | フォーマット変更、コード変更なし |
refactor | 機能追加・バグ修正を伴わないコード変更 |
test | テストの追加または更新 |
chore | ビルド、ツール、依存関係 |
例:
feat(auth): add login endpointfix(api): correct date parsingdocs: update README setup steps
確認チェックリスト
- GitHub の操作には GitHub MCP のみを使用します(REST API は使用せず、コマンド内に GITHUB_TOKEN を含めません)。
- force push、ブランチの削除、リポジトリの削除の前に確認します。
- デフォルトブランチ:
main。 - すべてのコミットで Conventional Commits の形式を使用します。
コメント
Markdown 対応