What problem does it solve?
Manual Git operations like crafting conventional commit messages, calculating semantic versions, and writing detailed pull request descriptions are repetitive and time-consuming for developers. This skill automates these workflows, accelerating release cycles and ensuring consistent Git history.
Core Features & Use Cases
- Conventional Commit Generation: Analyzes
git diff to categorize changes (feat/fix/refactor/docs/test) and generates conventional commit messages with auto-footers.
- Semantic Versioning & Tagging: Automatically calculates the next semantic version (major.minor.patch) based on commit history and creates annotated Git tags (wip-, dod-verified-, stable-v*).
- Pull Request Automation: Generates comprehensive PR descriptions from commit messages, auto-links related priorities/issues, and creates PRs via the GitHub API.
- Time Savings: Reduces the time spent on Git operations from 10-15 minutes to 2-3 minutes per release cycle, an 87% reduction.
- Use Case: A
code_developer completes a feature. They use this skill to automatically generate a conventional commit message, create a wip tag, and then, after DoD verification, create a stable release tag and a detailed pull request, all with minimal manual input.
Quick Start
# After implementing a feature and tests pass
# 1. Auto-generate conventional commit message
python scripts/git_commit_generator.py --diff-since last-tag
# 2. Create semantic version tag (e.g., minor bump for new features)
python scripts/semantic_tagger.py --version-auto
# 3. Create PR with auto-generated summary
python scripts/pr_creator.py --auto --from roadmap --to main