Communitygithub.com

G1Joshi/Agent-Skills - Git

Professionelle Git-Versionsverwaltung mit Branching, interaktivem Rebase, Cherry-Pick, Submodulen, Worktrees und Konfliktlösung – für die Verwaltung von Quellcode-Historie und Kollaborations-Workflows.

Was ist Agent-Skills - Git?

Diese Skill-Anleitung beschreibt die effiziente Nutzung von Git für professionelle Versionsverwaltung und Softwareentwicklung. Sie behandelt moderne Git-Features wie Sparse Checkout und Scalar für monorepos, die 3-Tree-Architektur (Working Tree, Index, HEAD) sowie die Arbeit mit dem DAG (gerichtetem azyklischen Graphen) und unveränderlichen Objekten. Entwickler lernen, wie sie mit `git switch` und `git restore` sauber navigieren, Merge- und Rebase-Strategien unterscheiden und mit Git Worktrees parallele Arbeitskontexte verwalten. Praktische Muster wie interaktiver Rebase für saubere Pull-Request-Historie und automatisierte Regression-Suche mit `git bisect` werden detailliert erläutert. Die Anleitung gibt bewährte Praktiken (z. B. signierte Commits, `--force-with-lease`, konventionelle Commits) sowie Anti-Patterns (Kein Force-Push auf geschützte Branches, keine Secrets in Repos) vor und enthält eine Troubleshooting-Tabelle. Plattformunabhängig einsetzbar (CLI, CI/CD, IDEs), eignet sich der Skill besonders für alle, die mit verteilten Teams, monolithischen Repos oder historisch gewachsenen Codebasen arbeiten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/G1Joshi/Agent-Skills/tree/HEAD/skills/tools/git

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Git

Git ist die Grundlage moderner Software. 2025 werden Funktionen wie Sparse Checkout und Scalar (für Monorepos) zum Standard.

Wann verwenden

  • Branching & Zusammenarbeit: Verwaltung von Feature-Isolation, Pull-Requests, trunk-basierter Entwicklung und Code-Reviews über verteilte Teams.
  • Historie umschreiben & bereinigen: Linearisieren von Commit-Graphen, Squashen von WIP-Commits und Bearbeiten von Nachrichten mittels git rebase -i vor dem Mergen in Hauptbranches.
  • Automatisierte Fehlersuche: Isolieren von regressionseinführenden Commits über tausende Revisionen mit binärer Suche via git bisect.
  • Parallele Arbeitskontexte: Arbeiten an dringenden Hotfixes ohne Stashen oder Branch-Wechsel mit git worktree.
  • Große Repositorys skalieren: Optimierung der Performance in massiven Monorepos mit Git Sparse Checkout, Scalar und flachen Klonen.

Schnellstart

# Repository klonen und neuen Feature-Branch erstellen
git clone https://github.com/myorg/project.git
cd project

# Mit modernem Befehl neuen Branch erstellen und wechseln
git switch -c feature/auth-flow

# Stagen, committen und pushen mit Upstream-Tracking
git add .
git commit -m "feat(auth): implement oauth2 authorization code flow"
git push -u origin feature/auth-flow

Kernkonzepte

Die 3-Tree-Architektur (Working Tree, Index, HEAD)

Git verwaltet Dateien über drei verschiedene Zustände, anstatt einfach Änderungen zwischen Revisionen zu verfolgen:

# 1. Working Tree: Geänderte, nicht committete Dateien im Editor
echo "export const API_URL = 'https://api.v2.internal';" >> config.ts

# 2. Index (Staging-Bereich): Für den nächsten Commit vorbereiteter Inhalt
git add config.ts

# 3. HEAD: Der letzte Commit-Snapshot auf dem aktiven Branch
git diff --staged  # Unterschied zwischen Staging und HEAD anzeigen
git commit -m "chore(config): update internal API endpoint"

Gerichteter azyklischer Graph (DAG) und unveränderliche Objekte

Jeder Commit in Git ist ein unveränderlicher Knoten, der auf Eltern-Hashes und einen Wurzelbaum von Blob-Snapshots zeigt.

# Das rohe Objekt hinter jedem Commit-Hash oder HEAD anzeigen
git cat-file -p HEAD
# Ausgabe:
# tree 4b825dc642cb6eb9a060e54bf8d69288fbee4904
# parent 8f3d1e1c3a628a58a98b47cf7d12a9e32049e712
# author Alice <[email protected]> 1727420400 +0000
# committer Alice <[email protected]> 1727420400 +0000
#
# feat(auth): implement oauth2 authorization code flow

Moderne Branch-Navigation (git switch vs git restore)

Modernes Git trennt den überladenen git checkout-Befehl in dedizierte Operationen:

# Branch-Wechsel (ersetzt git checkout <branch>)
git switch main
git switch -c feature/payments   # Erstellen und wechseln

# Datei-Wiederherstellung (ersetzt git checkout -- <datei>)
git restore src/app.ts           # Nicht committete Arbeitsverzeichnis-Änderungen verwerfen
git restore --staged src/app.ts  # Datei aus dem Index zurück ins Working Tree verschieben

Rebase- vs. Merge-Strategien

  • Merge (git merge <branch>): Behält den vollständigen historischen Kontext mit einem Merge-Commit mit zwei Eltern. Ideal für die Integration langlebiger Release-Branches.
  • Rebase (git rebase <upstream>): Spult Topic-Commits linear auf den HEAD des Upstream-Branches und verhindert so verworrene „Eisenbahnschienen“-Graphen. Ideal zum Bereinigen von Feature-Branches vor der PR-Überprüfung.
# Feature-Branch sauber auf den aktuellen main rebasen
git switch feature/auth-flow
git fetch origin main
git rebase origin/main

Häufige Muster

Multi-Branch-Entwicklung mit Git Worktrees

Problem: Uncommittete Arbeit stashen, um Branches zu wechseln und einen dringenden Produktionsfehler zu beheben.

Lösung: Mehrere Branches gleichzeitig in separaten Verzeichnissen auschecken:

# Parallelen Worktree-Ordner für den Hotfix-Branch erstellen
git worktree add ../hotfix-branch main

# Am Hotfix im separaten Verzeichnis arbeiten, ohne das aktuelle Arbeitsverzeichnis zu beeinflussen
cd ../hotfix-branch
git commit -am "fix: patch critical auth vulnerability"
git push origin hotfix-branch

# Worktree nach Abschluss entfernen
cd ../project
git worktree remove ../hotfix-branch

Interaktiver Rebase für saubere Pull-Request-Historie

Problem: Der Feature-Branch enthält Dutzende unordentlicher „WIP“-, „fix typo“- oder „checkpoint“-Commits. Lösung: Historie interaktiv squashen und bereinigen, bevor ein Pull-Request geöffnet wird.

# Die letzten 4 Commits interaktiv rebasen
git rebase -i HEAD~4

# Im interaktiven Editor:
# pick 8f3d1e1 feat(auth): add token generation
# squash 4b825dc fix typo in token payload
# squash a1c94e2 add missing import
# reword 91f7a02 feat(auth): add refresh token endpoint

Automatisierte Regression-Suche mit Git Bisect

Problem: Ein Fehler wurde irgendwo über 500 Commits hinweg eingeführt, aber der genaue Commit ist unbekannt. Lösung: Binäre Suche mit automatisiertem Testskript durchführen.

# Bisect-Sitzung starten
git bisect start
git bisect bad HEAD                  # Aktueller HEAD ist defekt
git bisect good v2.1.0               # v2.1.0 war bekanntermaßen funktionsfähig

# Tests bei jedem Bisect-Schritt automatisch ausführen
git bisect run npm test -- --runInBand

# Git endet bei dem genauen ersten Commit, der die Testsuite zerstört hat
git bisect reset

Bewährte Praktiken (2026)

Tun:

  • git switch und git restore verwenden: Den überladenen git checkout vermeiden, um versehentliche Branch-Wechsel oder Dateiüberschreibungen zu verhindern.
  • Mit --force-with-lease pushen: Überschreiben von Commits von Kollegen auf entfernten Branches verhindern.
  • Hintergrundwartung aktivieren: git maintenance start ausführen, um Packfiles, Commit-Graphen und Fetch-Leistung zu optimieren.
  • Commits mit SSH/GPG signieren: Authentizität der Commit-Autorenschaft in Produktions-Pipelines garantieren.
  • Konventionelle Commits verwenden: Standardisierte Präfixe (feat:, fix:, chore:, refactor:) nutzen, um semantische Versionierung und Changelogs zu automatisieren.

Nicht tun:

  • Nicht Force-Push auf geschützte Branches: Historie auf main, master oder gemeinsamen Release-Branches nie umschreiben.
  • Keine Secrets oder Zugangsdaten committen: .gitignore und git-secrets/trufflehog verwenden; einmal committete Zugangsdaten bleiben in Packfile-Blobs erhalten, selbst wenn sie später gelöscht werden.
  • Keine großen Binärdateien direkt verwenden: Große Modellgewichte oder Medien in Git LFS (Large File Storage) oder S3 speichern.
  • Dirty Working Trees nicht mergen: Vor Pull oder Rebase Änderungen stashen oder committen, um versehentliche Dateikonflikte zu vermeiden.

Fehlerbehebung

FehlerUrsacheLösung
fatal: refusing to merge unrelated historiesPull von einem Repository, das unabhängig ohne gemeinsamen Root-Commit initialisiert wurde.git pull origin main --allow-unrelated-histories ausführen.
HEAD detached at ...Ein bestimmter Commit-Hash statt eines Branch-Namens ausgecheckt.Branch von aktueller Position erstellen: git switch -c recovery-branch.
Merge conflict in file.txtGleichzeitige Commits haben identische Zeilen in gegensätzlichen Branches geändert.Konfliktmarkierungen (<<<<<<<) auflösen, Datei stagen (git add) und git commit ausführen.

Referenzen

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

G1Joshi/Agent-Skills

Expert Dask distributed computing assistance covering Dask DataFrames, Arrays, Futures, and cluster scaling. Use when analyzing datasets too large for pandas on a single machine or multi-node cluster.

G1Joshi/Agent-Skills

Expert dbt (data build tool) assistance covering SQL modeling, Jinja macros, tests, documentation, and semantic layer. Use when building analytics engineering pipelines on BigQuery, Snowflake, or PostgreSQL.

G1Joshi/Agent-Skills

Expert JAX assistance covering Autograd, XLA compilation (`jit`), vectorization (`vmap`), and parallelization (`pmap`). Use when building high-performance numerical computing and cutting-edge deep learning research.

G1Joshi/Agent-Skills

Expert Ray distributed computing assistance covering Ray Core (actors, tasks), Ray Train, Ray Tune, and Ray Serve. Use when scaling Python compute and ML training across multi-node clusters.

G1Joshi/Agent-Skills

Expert K9s CLI assistance covering terminal Kubernetes cluster navigation, real-time log streaming, port forwarding, and pod debugging. Use when managing and troubleshooting Kubernetes clusters with speed.

G1Joshi/Agent-Skills

Expert SWC assistance covering high-performance Rust-based JavaScript/TypeScript compilation, .swcrc configuration, Jest testing via @swc/jest, and minification. Use when replacing Babel with SWC for faster builds, accelerating test execution, or compiling modern ECMAScript features.

G1Joshi/Agent-Skills

Expert Tig assistance covering text-mode interface for Git, interactive staging, commit graph visualization, diff exploration, and blame navigation. Use when navigating Git commit history in the terminal, staging hunks interactively, browsing file changes, or reviewing revisions.

G1Joshi/Agent-Skills

Expert Vim assistance covering modal editing, .vimrc configuration, registers, macros, search/replace, and plugin management via vim-plug. Use when editing text efficiently in terminal environments, writing Vimscript, recording macros, or configuring core Vim settings.

G1Joshi/Agent-Skills

Expert Zed editor assistance covering high-performance Rust-based text editing, multi-buffer editing, language server protocols (LSP), and AI assistant integrations. Use when configuring Zed settings.json, setting up language extensions, collaborating in real-time channels, or optimizing editor startup speed.

G1Joshi/Agent-Skills

Expert Zsh assistance covering shell customization, Oh My Zsh plugins, Zinit plugin manager, prompt engineering (Starship/Powerlevel10k), and shell scripting. Use when configuring .zshrc, writing Zsh automation scripts, optimizing shell startup time, or configuring tab-completion.

G1Joshi/Agent-Skills

Expert [skill-name] assistance covering [feature 1], [feature 2], and [feature 3]. Use when [working with X], [debugging Y], or [implementing Z].

Verwandte Skills