--- description: Generate conventional commit messages following best practices --- # Message Generation Skill - Semantic Commit Message Generation Generate well-formatted commit messages that follow the Conventional Commits standard with proper type, scope, subject, body, and footer. ## Operations - **subject** - Generate subject line: `(): ` - **body** - Compose commit body with bullet points - **footer** - Add footer with breaking changes and issue references - **validate** - Check conventional commits compliance - **complete** - Generate full commit message (subject + body + footer) ## Router Logic Parse $ARGUMENTS to determine which operation to perform: 1. Extract operation from first word of $ARGUMENTS 2. Extract remaining arguments as operation parameters 3. Route to appropriate instruction file: - "subject" → Read `/home/danie/projects/plugins/architect/open-plugins/plugins/git-commit-assistant/commands/message-generation/generate-subject.md` - "body" → Read `/home/danie/projects/plugins/architect/open-plugins/plugins/git-commit-assistant/commands/message-generation/write-body.md` - "footer" → Read `/home/danie/projects/plugins/architect/open-plugins/plugins/git-commit-assistant/commands/message-generation/add-footer.md` - "validate" → Read `/home/danie/projects/plugins/architect/open-plugins/plugins/git-commit-assistant/commands/message-generation/validate-message.md` - "complete" → Read `/home/danie/projects/plugins/architect/open-plugins/plugins/git-commit-assistant/commands/message-generation/complete-message.md` 4. Execute instructions with parameters 5. Return formatted commit message or validation results ## Error Handling - If operation is unknown, list available operations - If required parameters are missing, show required format - If message validation fails, provide specific corrections - If character limits exceeded, suggest rewording ## Usage Examples ```bash # Generate subject line only /message-generation subject type:feat scope:auth description:"add OAuth authentication" # Write commit body /message-generation body changes:"Implement OAuth2 flow,Add provider support,Include middleware" # Add footer with issue references /message-generation footer breaking:"authentication API changed" closes:123 # Validate existing message /message-generation validate message:"feat(auth): add OAuth" # Generate complete commit message /message-generation complete type:feat scope:auth files:"src/auth/oauth.js,src/auth/providers.js" ``` ## Conventional Commits Format **Message Structure:** ``` (): ← Max 50 chars, imperative mood ← Optional, wrap at 72 chars - Bullet point describing change 1 - Bullet point describing change 2