mcpField
G
github-repo-management

github-repo-management

github.com/fanthus開発162 回インストール今日更新
リポジトリ

github-repo-management について

github-repo-managementは、ローカルGitの作業とGitHubリポジトリのワークフローを扱うスキルです。リポジトリ設定、ブランチ、コミット、プルリクエストの手順に加え、認証情報や破壊的操作への注意点も示します。

主な機能

  1. 01ローカルGitコマンドの手順
  2. 02リポジトリの作成と設定
  3. 03ブランチとコミットのワークフロー
  4. 04GitHub MCP経由のプルリクエスト操作
  5. 05秘密情報と破壊的操作への対策

活用シーン

  1. 01リポジトリの作成と接続
  2. 02コミットの準備とプッシュ
  3. 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 リポジトリを作成して」と依頼した場合:

  1. GitHub 上に作成する(GitHub MCP のみを使用):

    • GitHub MCP の create_repository(または同等のもの)を使用し、name、任意の description、およびユーザーの意図に基づくデフォルト値の private を指定します。
  2. ローカルで origin を設定する(すでに git リポジトリ内にいる場合):

    git remote add origin https://github.com/<owner>/<repo>.git
    

    origin が存在し、新しいリポジトリを指すように変更する必要がある場合は、変更前に確認を求めてください。

  3. ローカルリポジトリがまだない場合:

    git init
    git remote add origin https://github.com/<owner>/<repo>.git
    
  4. 最初の push(少なくとも1つのコミットの後):

    git push -u origin main
    

    GitHub リポジトリが別のデフォルトブランチで作成された場合を除き、main を使用してください。


コードを push する

ユーザーが「コードを push して」または「GitHub に push して」と依頼した場合:

  1. git リポジトリがあることを確認する:git status を実行します。リポジトリでない場合は、git init を実行してリモートを設定するかどうか尋ねてください。
  2. リモートを確認する:git remote -v を実行します。origin がない場合は、リポジトリの URL を尋ねるか、先にリポジトリを作成してください。
  3. 適切にコミットする:
    • 変更を確認するために git status を実行します。
    • ステージングします:git add <paths> を実行するか、ユーザーがすべての変更を意図している場合は git add -A を実行します。
    • Conventional Commits に従ったメッセージでコミットします:git commit -m "type(scope): description"。
    • 未コミットの変更があり、ユーザーが「push」と言った場合は、先にコミットするかどうかを提案します。確認なしに force push しないでください。
  4. push する:git push origin <branch> を実行します。デフォルトブランチは main です。upstream が設定されていない場合は、git push -u origin main を実行します。

リポジトリ情報を取得する

ユーザーが「リポジトリ情報を取得して」、「リポジトリの詳細を教えて」、または「リポジトリを表示して」と依頼した場合:

  1. リポジトリを特定する:git remote get-url origin(owner/repo)またはユーザーが指定した owner/name を使用します。
  2. 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 endpoint
  • fix(api): correct date parsing
  • docs: update README setup steps

確認チェックリスト

  • GitHub の操作には GitHub MCP のみを使用します(REST API は使用せず、コマンド内に GITHUB_TOKEN を含めません)。
  • force push、ブランチの削除、リポジトリの削除の前に確認します。
  • デフォルトブランチ:main。
  • すべてのコミットで Conventional Commits の形式を使用します。

コメント