git-batch-commit

Git Batch Commit Optimizer

This skill optimizes version control workflows by detecting when too many files are staged for commit and automatically organizing them into logical, feature-based batches with Conventional Commit messages.

Capabilities

• Smart Threshold Detection: Automatically detects when staging area contains too many files (threshold-based analysis)
• Intelligent File Grouping: Groups files by feature/functionality, not just directory structure
• Change Analysis: Analyzes git diff to understand what each file modification does
• Conventional Commits: Generates commit messages following the standard (feat/fix/docs/refactor/chore/style/test/perf)
• Language-Aware Messages: Commit messages follow user's language preference (English/Chinese/etc.)
• Multi-Batch Execution: Executes multiple commits in logical sequence

Input Requirements

Git repository state:

• Working directory with git repository
• Modified/staged/untrayed files ready for commit
• User language preference (defaults to English)
• Optional: Custom threshold for file count (default: 10 files)
• Optional: Specific Conventional Commit scope preferences

Formats accepted:

• Direct git status/diff output
• File paths with change descriptions
• Text description of changes made

Output Formats

Results include:

• Analysis of file count and recommended batching strategy
• Grouped file sets by feature/functionality
• Conventional Commit messages for each batch (type/scope/description)
• Execution plan showing commit sequence
• Summary report of commits created

Output structure:

{
  "analysis": {
    "total_files": 25,
    "threshold": 10,
    "requires_batching": true,
    "recommended_batches": 3
  },
  "batches": [
    {
      "batch_id": 1,
      "commit_type": "feat",
      "scope": "authentication",
      "files": ["auth.py", "login.py"],
      "message": "feat(authentication): add OAuth2 login support"
    }
  ],
  "execution_summary": "Created 3 commits across feat, fix, and docs types"
}

How to Use

Example 1 - Auto-detect and batch: "Analyze my git staging area and create appropriate batch commits"

Example 2 - With language preference: "Create batch commits in Chinese for all these staged files"

Example 3 - Custom threshold: "Use a threshold of 15 files and batch my commits accordingly"

Example 4 - Specific commit types: "Group these changes and use 'feat' and 'refactor' commit types"

Scripts

• git_analyzer.py: Parses git status/diff, detects file counts, analyzes change types
• batch_committer.py: Groups files by feature, generates Conventional Commit messages, executes commits
• commit_language.py: Handles multilingual commit message generation

Conventional Commit Types

Standard Types Used:

• feat: New feature or functionality
• fix: Bug fix
• docs: Documentation changes only
• refactor: Code restructuring without feature changes
• chore: Maintenance tasks (dependencies, configs)
• style: Code style/formatting (no logic change)
• test: Adding or updating tests
• perf: Performance improvements

Scope Examples: (api), (ui), (auth), (database), (core)

Best Practices

1. Review before execution: Always review the proposed batches before committing
2. Meaningful scopes: Use clear, project-specific scopes for better commit history
3. Atomic commits: Each batch should represent a cohesive unit of change
4. Language consistency: Keep commit language consistent within a project
5. Threshold tuning: Adjust threshold based on project size and team preferences
6. Feature grouping: Prefer functional grouping over directory-based grouping

Limitations

• Requires git repository in working directory
• Cannot automatically resolve conflicts between batches
• Scope detection depends on file naming conventions and change analysis
• Language detection may require explicit user preference
• Some complex refactorings may need manual grouping
• Does not handle pre-commit hooks automatically (user must ensure hooks pass)

Configuration Options

Optional configuration via git_batch_config.json:

{
  "threshold": 10,
  "default_language": "en",
  "preferred_scopes": ["api", "ui", "core", "tests"],
  "commit_types": ["feat", "fix", "docs", "refactor", "chore"],
  "auto_execute": false
}

Safety Features

• Dry-run mode: Preview batches before committing
• Rollback support: Can amend or reset if issues detected
• Validation: Checks for unstaged critical files
• Conflict detection: Warns about potential file dependencies across batches