mr-generator

Features

• Automatic commit analysis: Analyzes git commits since diverging from main branch
• Smart categorization: Categorizes commits with appropriate emojis (🎉, ✨, 🐛, 💄, 🔥, 🚀, etc.)
• Jira integration: Supports Jira ticket numbers and can fetch descriptions
• Template-based: Uses your team's MR template format
• GitLab integration: Can create MRs directly using glab CLI
• Interactive preview: Shows MR preview before creation with edit capabilities

Installation

1. Ensure you have the required dependencies:

   # GitLab CLI
   pip install glab
   
   # Or follow installation instructions at https://gitlab.com/gitlab-org/cli
   

2. Make sure the script is executable:

   chmod +x scripts/mr_generator.py
   

Usage

Basic usage (outputs to terminal):

python3 scripts/mr_generator.py

With Jira ticket:

python3 scripts/mr_generator.py --jira PROJ-123

Create MR directly:

python3 scripts/mr_generator.py --create --jira PROJ-123

The tool will:

1. Generate the MR description
2. Ask for Jira ticket title if not found
3. Show a preview for confirmation
4. Create the MR with title format: RD-[ticket] [title]

Save to file:

python3 scripts/mr_generator.py --output mr_description.md

Create MR with custom title:

python3 scripts/mr_generator.py --create --title "Custom MR Title" --jira PROJ-123

MR Template

The tool uses this template format:

Closes #X or Relates to [link to backlog]

## What's new
- 🎉 Init of a new component
- ✨ [New feature](url)
- 🐛 [Bug fixed](url)
- 💄 [Glitch fixed](url)
- 🔥 [P1 bug fixed](url)
- 🚀 Something is deployed
- ...

## BTW
Something relevant fixed along the way (tech debt, doc).

## SCREENSHOTS
Screenshots of the app with your fix/new feature on.

## Requirements & Dependencies
- Required software (ex. Docker, Node)?
- Critical new dependency (ex. framework)

## Testing

Run the following commands

cd ... make help make tests

Commit Categorization

The tool automatically categorizes commits based on message content:

• 🎉 Init: init, initial, start
• ✨ Feature: feat, feature, add
• 🐛 Bug: fix, bug, patch
• 🔥 P1 Bug: p1, critical (with bug keywords)
• 💄 Style/UI: style, ui, glitch
• 🚀 Deploy: deploy, release
• 🔧 Refactor: refactor, tech debt, cleanup
• 📚 Docs: docs, documentation
• 🧪 Tests: test, tests
• 🔄 Changes: Default for other commits

Configuration

Jira Integration

Currently, Jira integration is manual (you provide the ticket number). Future versions could include:

• Automatic Jira API integration
• Ticket description fetching
• Status synchronization

Custom Template

To customize the MR template, modify the template variable in the MRGenerator.__init__ method in scripts/mr_generator.py.

Examples

Example 1: Generate MR for a feature branch

# On your feature branch
python3 scripts/mr_generator.py --jira PROJ-456 --create

Output:

✅ MR created successfully!
https://gitlab.com/cnty-ai/continuity/-/merge_requests/789

Example 2: Generate description without creating MR

python3 scripts/mr_generator.py --jira PROJ-789 --output description.md

Troubleshooting

Common Issues

1. "Not in a git repository"

   • Make sure you're in a git repository
   • Check that you have a remote named origin or main

2. "glab command not found"

   • Install GitLab CLI: https://gitlab.com/gitlab-org/cli
   • Authenticate: glab auth login

3. "Could not find main branch"

   • Ensure you have a main or origin/main branch
   • The tool tries both main and origin/main

Debug Mode

Add debug output by setting environment variable:

DEBUG=1 python3 scripts/mr_generator.py

Contributing

To extend this tool:

1. Add new commit categories: Update the categorize_commit method in mr_generator.py
2. Customize template: Modify the template variable in MRGenerator.__init__
3. Add new integrations: Extend the Jira integration or add other ticket systems
4. Improve categorization: Enhance the commit analysis logic

License

This skill is part of the OpenCode project and follows the same license terms.