Git Commit - Review, Fix & Commit Skill

Git Commit - Review, Fix & Commit

Overview

This skill reviews project consistency after code changes to ensure:

Code matches design documents
CHANGELOG is updated for new features/fixes
README reflects current functionality
No outdated documentation
~/history.log is updated with session summary (if exists)

When to Use

Trigger /git-commit after:

Completing a feature implementation
Fixing a bug
Before creating a PR
After significant code refactoring

Review Checklist

1. Code vs Design Docs

Check if implementation matches design:

Architecture follows design patterns
API endpoints match specification
Data models align with schema

# Find design docs
find . -name "DESIGN.md" -o -name "*.design.md" -o -name "design*.md"

2. CHANGELOG Update

Verify CHANGELOG.md includes:

New features added
Bugs fixed
Breaking changes noted
Version number updated (if applicable)

# Check recent changes vs CHANGELOG
git diff HEAD~5 --name-only
cat CHANGELOG.md | head -50

3. README Accuracy

Ensure README.md reflects:

Current installation steps
Updated usage examples
New CLI commands/options
Correct configuration

# Compare README with actual code
cat README.md

4. History Log Update

Check if ~/history.log exists and update it with session summary:

# Check if history.log exists
if [ -f ~/history.log ]; then
    echo "history.log exists, will update"
fi

If exists, append a summary of changes made in this session:

=== {DATE} {PROJECT_NAME} - {BRIEF_DESCRIPTION} ===

## Changes
- Feature/fix description
- Files modified
- PRs created

## Key Commands
- python hub/main.py search "query"
- etc.

5. Consistency Report

Generate a report:

## Consistency Check Report

### Files Changed
- [ ] List modified files

### Documentation Status
- [ ] CHANGELOG updated: Yes/No
- [ ] README accurate: Yes/No
- [ ] Design docs aligned: Yes/No
- [ ] ~/history.log updated: Yes/No/Not exists

### Issues Found
- Issue 1: ...
- Issue 2: ...

### Recommendations
- Action 1: ...
- Action 2: ...

Workflow

Code Changes Complete
        ↓
    /git-commit
        ↓
┌─────────────────────────┐
│ 1. Read changed files   │
│ 2. Check CHANGELOG      │
│ 3. Verify README        │
│ 4. Compare with docs    │
│ 5. Update ~/history.log │
│ 6. Generate report      │
│ 7. Fix issues (if any)  │
│ 8. Git commit & push    │
└─────────────────────────┘

Auto Commit

After fixing all issues, automatically commit and push:

Stage changes: git add modified files
Commit: Summarize code changes in simple, human-like message
Push: Push to remote branch
Create PR: If on feature branch, create PR with reviewer

Commit Message Style

ALWAYS use simple, human-like commit messages:

Keep messages short and natural
Summarize what the code changes actually do
Use casual, everyday language
Avoid formal conventions like "feat:", "chore:", "refactor:", etc.
Write like a human developer would in daily work
Never include any Claude-related attribution:
- No "Generated with Claude Code"
- No "Co-Authored-By: Claude"

Good examples:

add user login
fix slow queries
update packages
add image download to browser fetcher
store s3 paths in opensearch

Bad examples:

feat: implement comprehensive user authentication system with JWT token validation
chore: update dependencies to latest versions
docs: update CHANGELOG for feature xyz

# Example commit flow
git add .
git commit -m "add browser fetcher with screenshot support"
git push origin <branch>
gh pr create --reviewer tsaol  # if on feature branch

Usage

/git-commit              # Full consistency review
/git-commit --quick      # Quick check (CHANGELOG + README only)
/git-commit --verbose    # Detailed report with suggestions

Example Output

## Git Check Report

### Changed Files (last commit)
- src/storage.py
- src/main.py

### CHANGELOG Status
⚠️  CHANGELOG.md not updated for recent changes

### README Status
✅ README.md is up to date

### Recommendations
1. Add entry to CHANGELOG.md:
   - "save url/source/category in sent_news.json"

Agent Skills: Git Commit - Review, Fix & Commit

Install this agent skill to your local

Skill Files