| name | commit |
| description | Generates git commit messages following Conventional Commits 1.0.0 specification with semantic types (feat, fix, etc.), optional scope, and breaking change annotations. Use when committing code changes or creating commit messages. Triggers on phrases like 'commit', 'commit and push', 'make a commit', 'git commit', or when commit is part of a compound action (e.g., 'bump version and commit'). |
Conventional Commit Generator
Workflow
-
Run git status and git diff HEAD to analyze changes
-
Stage files: user-specified only, or git add -A for all
-
Commit using HEREDOC format:
git commit -m "$(cat <<'EOF'
<type>(<scope>): <description>
EOF
)"
-
Output: <hash> <subject>
DO NOT: Modify code, push (unless asked), amend without request
Format
<type>[scope][!]: <description>
Types: feat, fix, perf, refactor, style, test, docs, build, ci, revert, chore
Subject: Imperative mood ("Add" not "Added"), capitalize first letter, no period, ~50 chars (max 72)
Scope: Optional noun for affected area (e.g., auth, api, parser)
Breaking changes: Add exclamation mark before colon: feat(api)!: Remove deprecated endpoints
Issue references: Use footer: Closes #123 or Fixes #456
Body (when needed)
Add body for non-trivial changes. Explain what and why, not how. Wrap at 72 chars.
