mcpField
G
git-master

git-master

github.com/josiahsiegel開発59794 回インストール19 週間前に更新
リポジトリ

git-master について

git-masterは、基本から高度なGit操作を扱うスキルガイドです。破壊的なコマンドへの安全策、コミット方法の確認、プラットフォーム別の手順を重視します。

主な機能

  1. 01基本から高度なGit操作ガイド
  2. 02破壊的コマンドの安全確認
  3. 03希望に応じたコミット対応
  4. 04プラットフォーム別の手順
  5. 05トラブルシューティングと復旧

活用シーン

  1. 01ブランチ・コミット・マージ手順の計画
  2. 02リセットや強制プッシュの安全な実行
  3. 03削除したコミットやブランチの復旧

インストール

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

$npx skills add https://github.com/josiahsiegel/claude-plugin-marketplace --skill git-master

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

同梱ファイル

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

references/
advanced-commands.md
basic-operations.md
cross-platform.md
dangerous-operations.md
hooks-and-security.md
merging-rebasing.md
performance-large-files.md
platform-workflows.md
troubleshooting-recovery.md

詳細

Git マスタリー - Git の完全な専門知識

基本操作から高度な操作までを網羅する包括的な Git スキルです。破壊的なコマンドに対する必須の安全策と、プラットフォーム固有のワークフローを含みます。

重要なガイドライン

Windows のファイルパス要件

Windows で Edit または Write ツールを使用する場合、ファイルパスにはスラッシュ（/）ではなくバックスラッシュ（\）を使用してください。

  • 誤り：D:/repos/project/file.tsx
  • 正しい：D:\repos\project\file.tsx

対象：Edit/Write の file_path パラメーター、およびすべてのファイル操作。

ドキュメント作成のガイドライン

ユーザーから明示的に依頼されない限り、新しいドキュメントファイルを作成しないでください。既存の README.md ファイルを更新することを優先してください。ドキュメントは簡潔で、直接的かつ専門的な内容にしてください。

要約：安全を最優先

破壊的な操作を行う前に、必ず次の手順を実行してください。

# ALWAYS check status first
git status
git log --oneline -10

# For risky operations, create a safety branch
git branch backup-$(date +%Y%m%d-%H%M%S)

# Remember: git reflog is your safety net (90 days default)
git reflog

ユーザーの希望を確認（Git タスクの開始時に必ず確認）：

「どのように進めますか？

  1. 適切なメッセージを付けて、コミットを自動作成する
  2. 変更をステージングするだけにして、コミットは手動で行う
  3. ガイダンスのみを提供する（自動操作は行わない）」

セッション全体を通して、この選択を尊重してください。

このスキルを使用する場面

次のような Git コマンドや操作を行う場合は、必ずこのスキルを有効にしてください。

  • リポジトリの初期化、クローン、設定
  • ブランチの管理と戦略
  • コミットのワークフローとベストプラクティス
  • マージ戦略と競合の解決
  • リベース操作（対話型および非対話型）
  • 履歴の書き換え（filter-repo、reset、revert）
  • 復旧操作（reflog、fsck）
  • 危険な操作（強制プッシュ、ハードリセット）
  • プラットフォーム固有のワークフロー（GitHub、Azure DevOps、Bitbucket、GitLab）
  • 高度な機能（サブモジュール、ワークツリー、フック）
  • パフォーマンスの最適化、大容量ファイル（LFS）
  • クロスプラットフォーム互換性（Windows/Linux/macOS）

主な該当例： ユーザーが Git、GitHub、GitLab、Bitbucket、Azure DevOps、バージョン管理、commit/push/pull/merge/rebase、ブランチ管理、履歴の変更、または復旧のシナリオに言及した場合。

基本原則

1. 破壊的な操作に対する安全策

破壊的な操作（reset --hard、強制プッシュ、filter-repo など）を行う前に、必ず次の手順を実行してください。

  1. ユーザーにはっきりと警告する
  2. リスクを明確に説明する
  3. 確認を求める
  4. 最初にバックアップブランチを作成するよう提案する
  5. 復旧手順を提示する

完全な安全プロトコルと確認用スクリプトについては、references/dangerous-operations.md を参照してください。

2. コミット作成ポリシー

Git タスクの開始時に、必ずユーザーの希望（自動作成／ステージングのみ／ガイダンスのみ）を確認してください。セッション全体を通して、この選択を尊重してください。

3. プラットフォームへの配慮

Git の動作は、プラットフォームやホスティングプロバイダーによって異なります。

  • Windows（Git Bash/PowerShell）： 改行コード（core.autocrlf）、パス区切り文字、大文字と小文字の区別、Windows 資格情報マネージャー
  • Linux/macOS： 大文字と小文字を区別するファイルシステム、SSH キーの管理、権限
  • ホスティングプラットフォーム： GitHub（PR、Actions、gh CLI）、Azure DevOps（PR、Pipelines、ポリシー）、Bitbucket（PR、Pipelines、Jira）、GitLab（MR、CI/CD）

ホスティングサービス固有のコマンドについては references/platform-workflows.md を、Windows/Linux/macOS の取り扱いについては references/cross-platform.md を参照してください。

リファレンスマップ

この SKILL.md は簡潔なオーケストレーターです。詳細なコマンドカタログと手順は references/ にあります。

リファレンス内容
references/basic-operations.md初期化、クローン、設定、基本的なワークフロー、ブランチ、リモート、fetch/pull/push（破壊的でない操作）
references/merging-rebasing.mdマージ戦略、競合の解決、リベース（対話型／onto／autosquash）、cherry-pick
references/advanced-commands.mdstash（Git 2.51 以降のインポート／エクスポートを含む）、revert、reflog、bisect、clean、worktree、submodule、tag
references/dangerous-operations.mdreset（hard／soft／mixed）、強制プッシュ、filter-repo、プッシュ済みコミットの amend、安全プロトコル
references/platform-workflows.mdGitHub、Azure DevOps、Bitbucket、GitLab の CLI と CI/CD テンプレート
references/performance-large-files.mdGC、repack、fsck、LFS、浅いクローン、大容量ファイルの検出
references/hooks-and-security.mdクライアント／サーバーフック、認証情報の管理、SSH、GPG、シークレットの防止、Conventional Commits
references/troubleshooting-recovery.mdよくある問題、復旧シナリオ、緊急コマンド
references/cross-platform.md改行コード、大文字と小文字の区別、Git Bash/MINGW のパス変換、シェルの検出

クイックコマンドインデックス

タスクリファレンス
git init、git clone、git add、git commit、git log、git diffbasic-operations
git branch、git switch、git remote、git fetch、git pull、git pushbasic-operations
git merge、競合マーカー、git rebase -i、git cherry-pickmerging-rebasing
git stash、git revert、git reflog、git bisect、git clean、git worktree、git submodule、git tagadvanced-commands
git reset --hard、git push --force[-with-lease]、git filter-repo、プッシュ済みコミットの amenddangerous-operations
gh pr、az repos pr、bb pr、glab mr、CI/CD YAMLplatform-workflows
git gc、git repack、git lfs、浅いクローンperformance-large-files
.git/hooks/*、Conventional Commits、SSH/GPG/シークレットhooks-and-security
detached HEAD、ブランチ／ファイル／コミットの復元、破損したリポジトリtroubleshooting-recovery
core.autocrlf、core.ignorecase、MSYS_NO_PATHCONV、cygpath、$MSYSTEMcross-platform

成功基準

このスキルを使用する Git ワークフローでは、次のことを行う必要があります。

  1. 自動コミットと手動コミットのどちらを希望するか、必ずユーザーに確認します
  2. 破壊的な操作の前には、必ず警告します
  3. リスクのある操作の前には、必ずバックアップブランチを作成します
  4. 復旧手順を必ず説明します
  5. プロジェクトに適したブランチ戦略を使用します
  6. 意味のあるコミットメッセージを記述します
  7. クリーンで直線的なコミット履歴を保ちます
  8. シークレットや大容量のバイナリファイルを決してコミットしません
  9. コミット前にコードをテストします
  10. あらゆるミスから復旧する方法を把握します

結びの注記

リファレンスファイルと安全対策を組み合わせることで、このスキルはあらゆる Git 操作を安全かつ効果的に扱うための知識を提供します。コマンドの各カテゴリを実行する前に、必ず適切なリファレンスを読み込んでください。

コメント

Markdown 対応