sc-git

Git Operations Skill

Intelligent git operations with smart commit generation.

Quick Start

# Status analysis
/sc:git status

# Smart commit
/sc:git commit --smart-commit

# Interactive merge
/sc:git merge feature-branch --interactive

Behavioral Flow

1. Analyze - Check repository state and changes
2. Validate - Ensure operation is appropriate
3. Execute - Run git command with automation
4. Optimize - Apply smart messages and patterns
5. Report - Provide status and next steps

Flags

Flag	Type	Default	Description
--smart-commit	bool	false	Generate conventional commit message
--interactive	bool	false	Guided operation mode

Evidence Requirements

This skill does NOT require hard evidence. Git operations are self-documenting through:

• Commit history
• Branch state
• Repository logs

Operations

Status Analysis

/sc:git status
# Repository state with change summary
# Actionable recommendations

Smart Commit

/sc:git commit --smart-commit
# Analyzes changes
# Generates conventional commit message
# Format: type(scope): description

Branch Operations

/sc:git branch feature/new-feature
/sc:git checkout main
/sc:git merge feature-branch

Interactive Operations

/sc:git merge feature --interactive
# Guided merge with conflict resolution
# Step-by-step assistance

Commit Message Format

Smart commits follow Conventional Commits:

type(scope): description

[optional body]

[optional footer]

Types:

• feat - New feature
• fix - Bug fix
• docs - Documentation
• refactor - Code restructuring
• test - Test additions
• chore - Maintenance

Examples

Analyze Changes

/sc:git status
# Summary of staged/unstaged changes
# Recommended next actions

Commit with Analysis

/sc:git commit --smart-commit
# Scans diff, generates message:
# feat(auth): add JWT token refresh mechanism

Guided Merge

/sc:git merge feature/auth --interactive
# Conflict detection and resolution guidance
# Step-by-step assistance

MCP Integration

PAL MCP (Validation & Review)

Tool	When to Use	Purpose
mcp__pal__precommit	Before commit	Comprehensive change validation
mcp__pal__codereview	Before merge	Code quality review of changes
mcp__pal__consensus	Merge conflicts	Multi-model resolution strategy
mcp__pal__debug	Git issues	Investigate repository problems

PAL Usage Patterns

# Pre-commit validation (--smart-commit)
mcp__pal__precommit(
    path="/path/to/repo",
    step="Validating changes before commit",
    findings="Security, completeness, test coverage",
    include_staged=True,
    include_unstaged=False
)

# Review before merge
mcp__pal__codereview(
    review_type="full",
    step="Reviewing feature branch before merge",
    findings="Quality, security, breaking changes",
    compare_to="main"
)

# Consensus on merge conflict resolution
mcp__pal__consensus(
    models=[{"model": "gpt-5.2", "stance": "neutral"}, {"model": "gemini-3-pro", "stance": "neutral"}],
    step="Evaluate: Which conflict resolution preserves intended behavior?"
)

Rube MCP (Automation & Notifications)

Tool	When to Use	Purpose
mcp__rube__RUBE_SEARCH_TOOLS	GitHub/GitLab	Find repository management tools
mcp__rube__RUBE_MULTI_EXECUTE_TOOL	PR/notifications	Create PRs, notify team, update issues
mcp__rube__RUBE_CREATE_UPDATE_RECIPE	Git workflows	Save reusable git automation

Rube Usage Patterns

# Create PR and notify team after commit
mcp__rube__RUBE_MULTI_EXECUTE_TOOL(tools=[
    {"tool_slug": "GITHUB_CREATE_PULL_REQUEST", "arguments": {
        "repo": "myapp",
        "title": "feat: Add user authentication",
        "body": "## Summary\n- Added JWT auth\n- Added refresh tokens",
        "base": "main",
        "head": "feature/auth"
    }},
    {"tool_slug": "SLACK_SEND_MESSAGE", "arguments": {
        "channel": "#pull-requests",
        "text": "New PR ready for review: feat: Add user authentication"
    }}
])

# Update issue status on merge
mcp__rube__RUBE_MULTI_EXECUTE_TOOL(tools=[
    {"tool_slug": "JIRA_UPDATE_ISSUE", "arguments": {
        "issue_key": "PROJ-123",
        "status": "Done"
    }},
    {"tool_slug": "GITHUB_CREATE_ISSUE_COMMENT", "arguments": {
        "repo": "myapp",
        "issue_number": 456,
        "body": "Merged in PR #789"
    }}
])

Flags (Extended)

Flag	Type	Default	Description
--pal-precommit	bool	false	Use PAL precommit validation
--pal-review	bool	false	Use PAL codereview before merge
--create-pr	bool	false	Create PR via Rube after commit
--notify	string	-	Notify via Rube (slack, teams, email)

Tool Coordination

• Bash - Git command execution
• Read - Repository state analysis
• Grep - Log parsing
• Write - Commit message generation
• PAL MCP - Pre-commit validation, code review, conflict resolution
• Rube MCP - PR creation, team notifications, issue updates