CUI Git Workflow Skill

EXECUTION MODE: You are now executing this skill. DO NOT explain or summarize these instructions to the user. IMMEDIATELY begin the workflow below based on the task context.

Provides git commit workflow following conventional commits specification. Includes artifact cleanup, commit formatting, and optional push/PR creation.

What This Skill Provides

Commit Workflow (Absorbs commit-changes Agent)

Complete git commit workflow:

• Artifact detection and cleanup
• Commit message generation following conventional commits
• Optional push to remote
• Optional PR creation

Commit Standards

• Format:

  <type>(<scope>): <subject>

• Types: feat, fix, docs, style, refactor, perf, test, chore
• Quality: imperative mood, lowercase, no period, max 50 chars

When to Activate This Skill

• Committing changes to repository
• Generating commit messages from diffs
• Cleaning build artifacts before commit
• Creating pull requests after commit

Workflow: Commit Changes

Purpose: Commit all uncommitted changes following Git Commit Standards.

Input Parameters:

• message (optional): Custom commit message
• push (optional): Push after committing
• create-pr (optional): Create PR after pushing

Steps

Step 1: Load Commit Standards

Read standards/git-commit-standards.md

Step 2: Check for Uncommitted Changes

git status --porcelain

If no changes → Report "No changes to commit"

Step 3: Analyze Changes for Artifacts

Use Glob to detect artifacts:

Glob pattern="**/*.class"
Glob pattern="**/*.temp"

Artifact patterns to clean:

• *.class

  files in

  src/

  directories

• *.temp

  temporary files
• Files in

  target/

  or

  build/

  accidentally staged

Step 4: Clean Artifacts

Safe Deletions (automatic):

• *.class

  in

  src/main/java

  or

  src/test/java

• *.temp

  anywhere
• Delete using

  rm <file>

Uncertain Cases (ask user):

• Files >1MB
• Files outside safe list
• Files in

  target/

  that are tracked

Step 5: Generate Commit Message

If custom message provided:

• Validate format
• Use provided message

If no message:

• Analyze diff using script:

  python3 .plan/execute-script.py pm-workflow:workflow-integration-git:git-workflow analyze-diff --file <diff-file>
  

• Generate message following standards

Multi-type priority: fix > feat > perf > refactor > docs > style > test > chore

Step 6: Stage and Commit

git add .
git commit -m "$(cat <<'EOF'
{commit_message}

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
EOF
)"

Step 7: Push (Optional)

If

push

git push

Step 8: Create PR (Optional)

If

create-pr

gh pr create --title "{title}" --body "$(cat <<'EOF'
## Summary
{summary}

🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"

Output

{
  "status": "success",
  "commit_hash": "abc123",
  "commit_message": "feat(http): add retry configuration",
  "files_changed": 5,
  "artifacts_cleaned": 2,
  "pushed": true,
  "pr_url": "https://github.com/..."
}

Scripts

Script:

pm-workflow:workflow-integration-git:git-workflow

format-commit

--type --subject [--scope] [--body] [--breaking] [--footer]

analyze-diff

--file

format-commit

Format commit message following conventional commits.

python3 .plan/execute-script.py pm-workflow:workflow-integration-git:git-workflow format-commit \
  --type feat \
  --scope http \
  --subject "add retry config" \
  [--body "Extended description..."] \
  [--breaking "API changed"] \
  [--footer "Fixes #123"]

Parameters:

• --type

  (required): Commit type (feat, fix, docs, style, refactor, perf, test, chore)

• --subject

  (required): Commit subject line

• --scope

  : Optional component scope

• --body

  : Optional commit body

• --breaking

  : Optional breaking change description

• --footer

  : Optional additional footer

Output (JSON):

{
  "type": "feat",
  "scope": "http",
  "subject": "add retry config",
  "formatted_message": "feat(http): add retry config\n\n🤖 Generated...",
  "validation": {"valid": true, "warnings": []},
  "status": "success"
}

analyze-diff

Analyze diff file to suggest commit message parameters.

python3 .plan/execute-script.py pm-workflow:workflow-integration-git:git-workflow analyze-diff \
  --file changes.diff

Parameters:

• --file

  (required): Path to diff file to analyze

Output (JSON):

{
  "mode": "analysis",
  "suggestions": {
    "type": "feat",
    "scope": "auth",
    "subject": null,
    "detected_changes": ["Significant new code added"],
    "files_changed": ["src/main/java/auth/Login.java"]
  },
  "status": "success"
}

Standards (Load On-Demand)

Git Commit Standards

Read standards/git-commit-standards.md

Provides:

• Conventional commits format specification
• Commit type definitions and usage
• Subject, body, and footer guidelines
• Best practices and anti-patterns

Critical Rules

Artifacts: NEVER commit

*.class

*.temp

*.backup*

push

create-pr

Integration

Skills Using This Skill

• plan-finalize - Commits and creates PR after plan execution
• plan-execute - May commit after task completion

Related Skills

• manage-lifecycle - Phase transitions that trigger finalize

Quality Verification

• Self-contained with relative path pattern
• Progressive disclosure (standards loaded on-demand)
• Script outputs JSON for machine processing
• commit-changes agent functionality absorbed
• Clear workflow definition
• Standards documentation maintained

References

• Conventional Commits: https://www.conventionalcommits.org/
• Git Commit Best Practices: https://cbea.ms/git-commit/
• Angular Commit Guidelines: https://github.com/angular/angular/blob/main/CONTRIBUTING.md#commit