Menu
Automated git workflow management for enterprise projects. Use for Conventional Commits formatting, CHANGELOG generation, commit validation, pre-commit hooks, release versioning, and semantic commits. CRITICAL - NO AI ATTRIBUTION IN COMMITS.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | git-commit-helper |
| description | Automated git workflow management for enterprise projects. Use for Conventional Commits formatting, CHANGELOG generation, commit validation, pre-commit hooks, release versioning, and semantic commits. CRITICAL - NO AI ATTRIBUTION IN COMMITS. |
Automated git workflow management for enterprise projects including Conventional Commits format, CHANGELOG generation, commit validation, and pre-commit hooks.
ABSOLUTELY FORBIDDEN in git commits:
# NEVER INCLUDE:
Generated with [Claude Code]
Co-Authored-By: Claude <noreply@anthropic.com>
This is NON-NEGOTIABLE:
Correct commit message format:
# CORRECT:
fix(api): improve error handling
- Fixed timeout handling in middleware
- Added error bubbling for failures
# WRONG - has AI attribution:
fix(api): improve error handling
- Fixed timeout handling in middleware
Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
If AI attribution accidentally added:
git commit --amend to rewrite message<type>(<scope>): <subject>
<body>
<footer>
feat: New feature
fix: Bug fix
docs: Documentation changes
style: Code style (formatting, no logic change)
refactor: Code restructuring (no behavior change)
perf: Performance improvement
test: Adding/updating tests
build: Build system changes
ci: CI/CD configuration
chore: Maintenance tasks
revert: Revert previous commit
security: Security-related changes
Customize scopes for your project. Example:
# API & Web
api: Public REST API (apps/api)
web-ui: Web interface (apps/web-ui)
# Services
worker: Background workers (services/*)
# Shared Packages
shared: Shared types (packages/shared)
# Infrastructure
infra: Infrastructure (infra/)
# Other
auth: Authentication/authorization
config: Configuration files
tests: Test suite
docs: Documentation
ci: CI/CD pipelines
Feature:
git commit -m "feat(api): add batch processing endpoint
- Support up to 100 items per request
- Add concurrent processing
- Return aggregated results with request IDs"
Bug Fix:
git commit -m "fix(worker): correct timeout handling
- Fix 1000ms timeout not being enforced
- Add graceful degradation on timeout
- Fixes #123"
Security:
git commit -m "security(auth): fix timing attack in key validation
- Use constant-time comparison for API keys
- Add rate limiting on auth endpoints"
#!/bin/bash
# scripts/smart-commit.sh
# Analyze changed files
CHANGED_FILES=$(git diff --cached --name-only)
# Infer scope from paths
SCOPE=""
if echo "$CHANGED_FILES" | grep -q "apps/api/"; then
SCOPE="api"
elif echo "$CHANGED_FILES" | grep -q "apps/web-ui/"; then
SCOPE="web-ui"
elif echo "$CHANGED_FILES" | grep -q "services/"; then
SCOPE="worker"
elif echo "$CHANGED_FILES" | grep -q "packages/"; then
SCOPE="shared"
elif echo "$CHANGED_FILES" | grep -q "infra/"; then
SCOPE="infra"
elif echo "$CHANGED_FILES" | grep -q "docs/"; then
SCOPE="docs"
elif echo "$CHANGED_FILES" | grep -qE "\.test\.(ts|js)$"; then
SCOPE="tests"
fi
# Prompt for type and subject
echo "Changed files:"
echo "$CHANGED_FILES"
echo ""
echo "Inferred scope: $SCOPE"
echo ""
echo "Select commit type:"
echo "1) feat"
echo "2) fix"
echo "3) docs"
echo "4) refactor"
echo "5) test"
echo "6) security"
read -p "Choice: " TYPE_CHOICE
case $TYPE_CHOICE in
1) TYPE="feat" ;;
2) TYPE="fix" ;;
3) TYPE="docs" ;;
4) TYPE="refactor" ;;
5) TYPE="test" ;;
6) TYPE="security" ;;
*) TYPE="chore" ;;
esac
read -p "Commit subject: " SUBJECT
# Build commit message (NO AI ATTRIBUTION!)
if [ -n "$SCOPE" ]; then
COMMIT_MSG="$TYPE($SCOPE): $SUBJECT"
else
COMMIT_MSG="$TYPE: $SUBJECT"
fi
# Show preview
echo ""
echo "Commit message:"
echo "$COMMIT_MSG"
echo ""
read -p "Proceed? (y/n): " CONFIRM
if [ "$CONFIRM" = "y" ]; then
git commit -m "$COMMIT_MSG"
echo "Committed successfully"
else
echo "Aborted"
fi
#!/bin/bash
# .git/hooks/pre-commit
echo "Running pre-commit checks..."
# 1. Check for AI attribution (FORBIDDEN!)
if git diff --cached | grep -iE "(Generated with.*Claude|Co-Authored-By:.*Claude)"; then
echo ""
echo "ERROR: AI attribution detected in staged changes!"
echo " Remove any 'Generated with Claude' or 'Co-Authored-By: Claude' lines"
echo ""
exit 1
fi
# 2. Run linter on staged files
if git diff --cached --name-only | grep -q ".ts$"; then
echo "Running TypeScript type check..."
pnpm typecheck || exit 1
fi
# 3. Run tests for changed services
CHANGED=$(git diff --cached --name-only)
if echo "$CHANGED" | grep -qE "services/"; then
echo "Running service tests..."
pnpm test || exit 1
fi
# 4. Check for secrets
echo "Checking for secrets..."
if git diff --cached | grep -iE "(password|secret|api_key|token).*(=|:).*['\"][^'\"]{8,}['\"]"; then
echo "WARNING: Potential secret detected in staged changes"
read -p "Continue anyway? (y/n): " CONFIRM
[ "$CONFIRM" != "y" ] && exit 1
fi
echo "Pre-commit checks passed"
#!/bin/bash
# .git/hooks/commit-msg
COMMIT_MSG_FILE=$1
COMMIT_MSG=$(cat "$COMMIT_MSG_FILE")
# CRITICAL: Check for AI attribution
if echo "$COMMIT_MSG" | grep -iE "(Generated with.*Claude|Co-Authored-By:.*Claude)"; then
echo ""
echo "FORBIDDEN: AI attribution detected in commit message!"
echo ""
exit 1
fi
# Conventional Commits regex
REGEX="^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert|security)(\(.+\))?: .{1,50}"
if ! echo "$COMMIT_MSG" | grep -qE "$REGEX"; then
echo ""
echo "Invalid commit message format"
echo ""
echo "Format: <type>(<scope>): <subject>"
echo ""
echo "Types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert, security"
echo ""
exit 1
fi
echo "Commit message format valid"
#!/bin/bash
# scripts/generate-changelog.sh
VERSION="$1"
PREV_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
echo "# Changelog"
echo ""
echo "## [$VERSION] - $(date +%Y-%m-%d)"
echo ""
# Group commits by type
for TYPE in feat fix security docs refactor perf test build ci chore; do
COMMITS=$(git log --pretty=format:"%s" ${PREV_TAG}..HEAD | grep "^$TYPE")
if [ -n "$COMMITS" ]; then
case $TYPE in
feat) SECTION="### Features" ;;
fix) SECTION="### Bug Fixes" ;;
security) SECTION="### Security" ;;
docs) SECTION="### Documentation" ;;
refactor) SECTION="### Refactoring" ;;
perf) SECTION="### Performance" ;;
test) SECTION="### Tests" ;;
build) SECTION="### Build" ;;
ci) SECTION="### CI/CD" ;;
chore) SECTION="### Chore" ;;
esac
echo "$SECTION"
echo ""
echo "$COMMITS" | while read line; do
MSG=$(echo "$line" | sed "s/^$TYPE[^:]*: //")
echo "- $MSG"
done
echo ""
fi
done
# Breaking changes
BREAKING=$(git log --pretty=format:"%b" ${PREV_TAG}..HEAD | grep "BREAKING")
if [ -n "$BREAKING" ]; then
echo "### BREAKING CHANGES"
echo ""
echo "$BREAKING"
echo ""
fi
# Install hooks
cp scripts/pre-commit.sh .git/hooks/pre-commit
chmod +x .git/hooks/pre-commit
cp scripts/commit-msg.sh .git/hooks/commit-msg
chmod +x .git/hooks/commit-msg
# Generate CHANGELOG
./scripts/generate-changelog.sh v1.0.0 > CHANGELOG.md
# Smart commit (no AI attribution)
./scripts/smart-commit.sh
Format: Conventional Commits 1.0.0 Validation: Pre-commit hooks (AI attribution check) CRITICAL: NO AI ATTRIBUTION IN COMMITS