К основному содержанию
скилл CX Codex

git-2025-features — скилл для Claude Code: возможности Git 2.48–2.49

Скилл git-2025-features для Claude Code и других платформ описывает возможности Git 2.48–2.49 и современные рабочие процессы. Агент использует его при работе с reftables, sparse-checkout, partial clone и worktrees.

MIT 164 установок ★ 66 обновлён 2026-06-18

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add JosiahSiegel/claude-plugin-marketplace --skill git-2025-features -a claude-code
Открыть на GitHub

Что делает git-2025-features

Агент получает справку по миграции на reftable-бэкенд, настройке sparse-checkout для монорепозиториев, частичному клонированию с фильтром --filter=blob:none, worktrees для параллельной разработки и оптимизации через commit graph. Внутри — примеры команд для проверки версии Git, переключения формата хранения ссылок, настройки cone mode и non-cone паттернов, создания worktree и prefetch недостающих объектов.

В скилле описаны улучшения производительности Git 2.48 (стабильное потребление памяти, завершение миграции reflogs на reftables) и 2.49 (интеграция zlib-ng, path-walk API для сжатия дельт, новый алгоритм name-hashing). Для репозиториев с десятками тысяч веток миграция на reftables даёт прирост скорости операций с ref на 50–80 процентов. Комбинация partial clone и sparse-checkout позволяет клонировать только нужные директории без загрузки всех блобов.

Лицензия MIT. Устанавливается через npx skills add с указанием агента (-a claude-code, -a cursor и так далее); для GitHub Copilot — через gh skill install.

Какие задачи решает

  • настроить sparse-checkout для работы с одним сервисом в монорепозитории
  • мигрировать репозиторий на reftable-бэкенд и проверить прирост скорости
  • создать worktree для ревью pull request, не прерывая текущую разработку
  • клонировать репозиторий с фильтром blob:none и загружать объекты по требованию
  • применить оптимизации Git 2.49 для ускорения сжатия и repack

Примеры запросов агенту

  • Покажи, как мигрировать репозиторий на reftables и откатить, если что-то сломается
  • Настрой sparse-checkout в cone mode для директорий src/api и src/shared
  • Создай worktree для ветки feature/new-api в отдельной директории

Как установить git-2025-features

1Через Skills CLI (Vercel)

npx skills add JosiahSiegel/claude-plugin-marketplace --skill git-2025-features -a claude-code

2Вручную: положить файлы

~/.claude/skills/git-2025-features/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/git-2025-features/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о git-2025-features

Как установить git-2025-features в Claude Code?

Выполните npx skills add JosiahSiegel/claude-plugin-marketplace --skill git-2025-features -a claude-code. Скилл появится в ~/.claude/skills/git-2025-features/SKILL.md.

Что делает git-2025-features?

Предоставляет агенту справку по возможностям Git версий 2.48–2.49: reftables, sparse-checkout, partial clone, worktrees, trunk-based development и оптимизации производительности. Скилл активируется при работе с этими функциями и содержит примеры команд для миграции и настройки.

Когда стоит мигрировать на reftables?

Когда в репозитории больше десяти тысяч веток или тегов, при частых операциях с ref в CI/CD, в монорепозиториях с активным ветвлением. Миграция ускоряет операции с ref на 50–80 процентов и делает обновления атомарными.

Исходный текст

SKILL.md · MIT
---
name: git-2025-features
description: |
  Git 2.49+ features and modern Git workflows (2025-2026).
  PROACTIVELY activate for: (1) Git 2.49+ features (reftables, sparse-checkout, partial clone, worktrees), (2) git-backfill for partial clones, (3) reftables migration (file backend to reftable backend), (4) sparse-checkout for monorepos, (5) git worktrees for parallel development, (6) partial clone (--filter=blob:none), (7) commit graph and bitmap optimizations, (8) trunk-based development workflows, (9) Git LFS, (10) modern alternatives to legacy commands.
  Provides: feature reference, version-detection snippets, sparse-checkout configuration, worktree workflow patterns, and migration guidance from older Git versions.
---

**📌 NOTE:** For detailed Git 2.49+ features (git-backfill, path-walk API, zlib-ng), see git-2-49-features.md skill.

## 🚨 CRITICAL GUIDELINES

### Windows File Path Requirements

**MANDATORY: Always Use Backslashes on Windows for File Paths**

When using Edit or Write tools on Windows, you MUST use backslashes (`\`) in file paths, NOT forward slashes (`/`).

**Examples:**
- ❌ WRONG: `D:/repos/project/file.tsx`
- ✅ CORRECT: `D:\repos\project\file.tsx`

This applies to:
- Edit tool file_path parameter
- Write tool file_path parameter
- All file operations on Windows systems


### Documentation Guidelines

**NEVER create new documentation files unless explicitly requested by the user.**

- **Priority**: Update existing README.md files rather than creating new documentation
- **Repository cleanliness**: Keep repository root clean - only README.md unless user requests otherwise
- **Style**: Documentation should be concise, direct, and professional - avoid AI-generated tone
- **User preference**: Only create additional .md files when user specifically asks for documentation


---

# Git 2025 Features - Advanced Capabilities

## Git 2.49 (March 2025) - Latest

**Major additions:** git-backfill, path-walk API, zlib-ng performance, improved delta compression.

**See git-2-49-features.md for complete coverage.**

## Git 2.48-2.49 Features

### Reftables Migration (Completed in 2.48)

**What:** New reference storage format replacing loose ref files and packed-refs.

**Benefits:**
- Faster ref operations (50-80% improvement)
- Atomic ref updates
- Better scalability for repositories with many refs
- Reflogs fully migratable (completed in 2.48)

**Migration:**

```bash
# Check current ref storage format
git config core.refStorage

# Migrate to reftables
git refs migrate --ref-storage=reftables

# Verify migration
git fsck --full
git log --oneline -5

# Roll back if needed (before critical operations)
git refs migrate --ref-storage=files
```

**When to use:**
- Repositories with 10,000+ refs
- High-frequency branch operations
- CI/CD systems creating many temporary refs
- Monorepos with extensive branching

### Performance Milestones (2.48-2.49)

**Git 2.48:**
- Memory leak free status achieved
- Stable memory usage in long-running operations

**Git 2.49:**
- zlib-ng integration: 20-30% faster compression
- Path-walk API: 50-70% better delta compression
- New name-hashing algorithm for optimal packfiles

Benefits automatically in:
- Large repository clones
- Extended rebase sessions
- Bulk operations (filter-repo, GC, repack)

## Sparse-Checkout (Enhanced in 2.48)

**What:** Check out only a subset of files from repository.

**Use cases:**
- Monorepos (work on one service)
- Large repositories (reduce disk usage)
- Build systems (fetch only needed files)

**Cone Mode (Default - Recommended):**

```bash
# Clone with sparse-checkout
git clone --filter=blob:none --sparse <repo-url>
cd <repo>

# Initialize sparse-checkout in cone mode
git sparse-checkout init --cone

# Add directories to checkout
git sparse-checkout set src/api src/shared docs

# Add more directories
git sparse-checkout add tests/integration

# View current patterns
git sparse-checkout list

# Check what would be matched
git sparse-checkout check-rules src/api/users.ts

# Disable sparse-checkout
git sparse-checkout disable
```

**Advanced Patterns (Non-Cone Mode):**

```bash
# Enable pattern mode
git sparse-checkout init --no-cone

# Add patterns (one per line)
git sparse-checkout set \
  "*.md" \
  "src/api/*" \
  "!src/api/legacy/*"

# Read patterns from file
git sparse-checkout set --stdin < patterns.txt
```

**Reapply Rules:**

```bash
# After merge/rebase that materialized unwanted files
git sparse-checkout reapply
```

## Partial Clone

**What:** Clone repository without downloading all objects initially.

**Filters:**

1. **blob:none** - Defer all blobs (fastest, smallest)
2. **tree:0** - Defer all trees and blobs
3. **blob:limit=1m** - Defer blobs larger than 1MB

**Usage:**

```bash
# Clone without blobs (fetch on demand)
git clone --filter=blob:none <repo-url>

# Clone without large files
git clone --filter=blob:limit=10m <repo-url>

# Combine with sparse-checkout
git clone --filter=blob:none --sparse <repo-url>
cd <repo>
git sparse-checkout set src/api

# Convert existing repository to partial clone
git config extensions.partialClone origin
git config remote.origin.promisor true
git fetch --filter=blob:none

# Prefetch all missing objects
git fetch --unshallow
```

**Combine Partial Clone + Sparse-Checkout:**

```bash
# Ultimate efficiency: Only objects for specific directories
git clone --filter=blob:none --sparse <repo-url>
cd <repo>
git sparse-checkout set --cone src/api
git checkout main

# Result: Only have objects for src/api
```

**Check promisor objects:**

```bash
# Verify partial clone status
git config extensions.partialClone

# See promisor packfiles
ls -lah .git/objects/pack/*.promisor

# Force fetch specific object
git rev-list --objects --missing=print HEAD | grep "^?"
```

## Git Worktrees

**What:** Multiple working directories from one repository.

**Benefits:**
- Work on multiple branches simultaneously
- No need to stash/commit before switching
- Parallel work (review PR while coding)
- Shared .git (one fetch updates all)

**Basic Operations:**

```bash
# List worktrees
git worktree list

# Create worktree for existing branch
git worktree add ../project-feature feature-branch

# Create worktree with new branch
git worktree add -b new-feature ../project-new-feature

# Create worktree from remote branch
git worktree add ../project-fix origin/fix-bug

# Remove worktree
git worktree remove ../project-feature

# Clean up stale worktree references
git worktree prune
```

**Advanced Patterns:**

```bash
# Worktree for PR review while coding
git worktree add ../myproject-pr-123 origin/pull/123/head
cd ../myproject-pr-123
# Review PR in separate directory
cd -
# Continue coding in main worktree

# Worktree for hotfix
git worktree add --detach ../myproject-hotfix v1.2.3
cd ../myproject-hotfix
# Make hotfix
git switch -c hotfix/security-patch
git commit -am "fix: patch vulnerability"
git push -u origin hotfix/security-patch

# Worktree organization
mkdir -p ~/worktrees/myproject
git worktree add ~/worktrees/myproject/feature-a -b feature-a
git worktree add ~/worktrees/myproject/feature-b -b feature-b
git worktree add ~/worktrees/myproject/pr-review origin/pull/42/head
```

**Best Practices:**

1. **Organize directory structure:**
```bash
~/projects/
  myproject/           # Main worktree
  myproject-feature/   # Feature worktree
  myproject-review/    # Review worktree
```

2. **Clean up regularly:**
```bash
# Remove merged worktrees
git worktree list | grep feature | while read wt branch commit; do
  if git branch --merged | grep -q "$branch"; then
    git worktree remove "$wt"
  fi
done
```

3. **Shared configuration:**
- .git/config applies to all worktrees
- .git/info/exclude applies to all worktrees
- Each worktree has own index and HEAD

## Scalar (Large Repository Tool)

**What:** Tool for optimizing very large repositories (Microsoft-developed).

```bash
# Install scalar (comes with Git 2.47+)
scalar register <path>

# Clone with scalar optimizations
scalar clone --branch main <repo-url>

# Enables automatically:
# - Sparse-checkout (cone mode)
# - Partial clone (blob:none)
# - Multi-pack-index
# - Commit-graph
# - Background maintenance

# Unregister
scalar unregister <path>

# Delete repository
scalar delete <path>
```

## Git Backfill (Experimental)

**What:** Background process to fetch missing objects in partial clone.

```bash
# Fetch missing blobs in background
git backfill

# Configure batch size
git backfill --min-batch-size=1000

# Respect sparse-checkout patterns
git backfill --sparse
```

## Performance Comparison

**Traditional Clone:**
```bash
git clone large-repo
# Size: 5GB, Time: 10 minutes
```

**Sparse-Checkout:**
```bash
git clone --sparse large-repo
git sparse-checkout set src/api
# Size: 500MB, Time: 3 minutes
```

**Partial Clone:**
```bash
git clone --filter=blob:none large-repo
# Size: 100MB, Time: 1 minute
```

**Partial Clone + Sparse-Checkout:**
```bash
git clone --filter=blob:none --sparse large-repo
git sparse-checkout set src/api
# Size: 50MB, Time: 30 seconds
```

## When to Use Each Feature

**Sparse-Checkout:**
- ✓ Monorepos
- ✓ Working on specific services/modules
- ✓ Limited disk space
- ✗ Need entire codebase often

**Partial Clone:**
- ✓ CI/CD pipelines
- ✓ Large repositories
- ✓ Good network connectivity
- ✗ Offline work frequently

**Worktrees:**
- ✓ Parallel development
- ✓ PR reviews during work
- ✓ Multiple branch testing
- ✗ Low disk space

**Combine All:**
- ✓ Massive monorepos (Google scale)
- ✓ Multiple simultaneous tasks
- ✓ Minimal local storage
- ✓ Fast network connection

## Troubleshooting

**Sparse-checkout not working:**
```bash
# Verify configuration
git config core.sparseCheckout
git config core.sparseCheckoutCone

# Re-apply patterns
git sparse-checkout reapply

# Check patterns
git sparse-checkout list
```

**Missing objects in partial clone:**
```bash
# Fetch specific object
git fetch origin <commit>

# Fetch all missing
git fetch --unshallow

# Verify promisor config
git config extensions.partialClone
```

**Worktree issues:**
```bash
# Locked worktree
git worktree unlock <path>

# Corrupted worktree
git worktree remove --force <path>
git worktree prune

# Branch already checked out
git checkout --ignore-other-worktrees <branch>
```

## Migration Guide

**From traditional to optimized workflow:**

```bash
# 1. Current large clone
cd large-project
du -sh .git  # 5GB

# 2. Create optimized new clone
cd ..
git clone --filter=blob:none --sparse large-project-new
cd large-project-new
git sparse-checkout set src/api src/shared

# 3. Verify size
du -sh .git  # 50MB

# 4. Switch workflow
cd ../large-project-new

# 5. Delete old clone when comfortable
rm -rf ../large-project
```

## Resources

- [Git Partial Clone Documentation](https://git-scm.com/docs/partial-clone)
- [Git Sparse-Checkout Guide](https://github.blog/open-source/git/bring-your-monorepo-down-to-size-with-sparse-checkout/)
- [Git Worktree Best Practices](https://git-scm.com/docs/git-worktree)
- [Scalar Documentation](https://github.com/microsoft/scalar)

© JosiahSiegel · MIT · JosiahSiegel/claude-plugin-marketplace

Похожие скиллы

Все скиллы по теме «Git и GitHub» →
conventional-git samber Скилл conventional-git задаёт правила именования веток и коммитов по стандарту Conventional Commits v1.0.0. Помогает поддерживать чистую историю проекта в GitHub и GitLab. CX Codex +1 5 400установок git-worktree-manager Alireza Rezvani Скилл git-worktree-manager для Claude Code создаёт изолированные Git worktrees для параллельной работы над ветками. Он назначает портам отдельные значения, копирует файлы окружения и помогает безопасно убрать устаревшие worktrees. CX Codex +1 581установок npm-git-install akillness Скилл npm-git-install для Claude Code выбирает безопасный способ поставить Node-пакет из ветки, коммита, форка или приватного репозитория. Закрывает выбор между Git-мостом, tarball и публикацией в реестр. CX Codex +1 351установок git-workflow-and-versioning addyosmani Скилл git-workflow-and-versioning, который наводит порядок в git-процессе: атомарные коммиты, короткоживущие ветки, сообщения, объясняющие зачем, а не что. Включается при любом изменении кода, которое агент готовит к коммиту. CX Codex +1 75 700установок git-worktree-isolation sentimony Скилл git-worktree-isolation оценивает риски правок и подбирает безопасное рабочее пространство перед началом задач. Помогает избежать затирания чужого кода при параллельной работе агентов. CX Codex +1 2 300установок git-workflow jezweb Скилл git-workflow ведёт агента по операциям Git: подготовке PR, чистке веток, разрешению конфликтов и выпуску тегов в монорепозитории. CX Codex +1 1 300установок

Из того же набора96

Весь набор →
defender-for-devops Скилл defender-for-devops для Claude Code помогает добавить проверки безопасности в Azure Pipelines. Активируется при настройке MSDO, сканировании кода, зависимостей, контейнеров и IaC. CX Codex +1 166установок docker-watch-mode-2025 Скилл docker-watch-mode-2025 настраивает watch в Docker Compose: правки исходников уезжают в контейнер без пересборки, а манифесты зависимостей пересобирают образ. CX Codex +1 166установок windows-git-bash-compatibility Скилл windows-git-bash-compatibility устраняет сбои путей и переменных окружения при сборке проектов Azure Data Factory в эмуляторе Git Bash на Windows. CX Codex +1 165установок windows-git-bash-testing Скилл windows-git-bash-testing разбирает падения тестов Vitest, Playwright и MSW, которые случаются только на Windows и в Git Bash: пути, снимки, браузеры. CX Codex +1 164установок adf-master Скилл adf-master помогает настроить CI/CD для Azure Data Factory, написать скрипты PrePostDeploymentScript и подготовить шаблоны ARM для развёртывания. CX Codex +1 164установок azure-sql-optimization Скилл azure-sql-optimization по оптимизации Azure SQL Database: помогает выбрать тариф, включить автоматическую настройку и разобраться с Hyperscale, Serverless и эластичными пулами. CX Codex +1 164установок container-apps-gpu-2025 Скилл container-apps-gpu-2025 для Claude Code — база знаний по Azure Container Apps с серверлесными GPU, профилями Dedicated, интеграцией Dapr и автомасштабированием до нуля. CX Codex +1 163установок docker-git-bash-guide Скилл docker-git-bash-guide помогает настроить Docker в Windows Git Bash и устранить ошибки монтирования томов из-за автоматической конвертации путей MSYS. CX Codex +1 163установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой