✨ feat: add commit_message and bdd_testing skills
- Create commit_message skill with Gitmoji validation and templates - Update bdd_testing skill to match validated BDD implementation - Add comprehensive documentation and validation scripts - Ensure all skills follow AGENTS.md conventions Generated by Mistral Vibe. Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
This commit is contained in:
180
.vibe/skills/commit_message/SKILL.md
Normal file
180
.vibe/skills/commit_message/SKILL.md
Normal file
@@ -0,0 +1,180 @@
|
||||
---
|
||||
name: commit_message
|
||||
description: Helps create proper Gitmoji commit messages following the Common Gitmoji Reference from AGENTS.md. Use when creating commits to ensure consistent, visual commit messages.
|
||||
license: MIT
|
||||
metadata:
|
||||
author: DanceLessonsCoach Team
|
||||
version: "1.0.0"
|
||||
based-on: AGENTS.md Common Gitmoji Reference
|
||||
---
|
||||
|
||||
# Commit Message Skill
|
||||
|
||||
This skill helps create proper Gitmoji commit messages following the Common Gitmoji Reference from AGENTS.md.
|
||||
|
||||
## Gitmoji Reference
|
||||
|
||||
### Feature Changes
|
||||
- **✨ `:sparkles:` feat**: New feature
|
||||
- **🐛 `:bug:` fix**: Bug fix
|
||||
- **♻️ `:recycle:` refactor**: Code refactoring
|
||||
- **🔥 `:fire:` remove**: Remove code/files
|
||||
- **🚀 `:rocket:` perf**: Performance improvements
|
||||
- **🔒 `:lock:` security**: Security fixes
|
||||
|
||||
### Documentation & Style
|
||||
- **📝 `:memo:` docs**: Documentation
|
||||
- **🎨 `:art:` style**: Code formatting
|
||||
- **📦 `:package:` dependencies**: Dependency changes
|
||||
|
||||
### Platform-Specific
|
||||
- **🐧 `:penguin:` linux**: Linux-specific changes
|
||||
- **🍎 `:apple:` macos**: macOS-specific changes
|
||||
- **🪟 `:window:` windows**: Windows-specific changes
|
||||
|
||||
### Testing & CI
|
||||
- **🧪 `:test_tube:` test**: Tests
|
||||
- **🤖 `:robot:` ci**: CI/CD changes
|
||||
|
||||
### Other
|
||||
- **📈 `:chart_with_upwards_trend:` analytics**: Analytics/SEO
|
||||
- **🌐 `:globe_with_meridians:` i18n**: Internationalization
|
||||
- **⚡ `:zap:` performance**: Performance improvements
|
||||
- **🔧 `:wrench:` chore**: Build/config changes
|
||||
|
||||
## Usage Examples
|
||||
|
||||
### New Feature
|
||||
```bash
|
||||
git commit -m "✨ feat: add user authentication"
|
||||
git commit -m "✨ feat: implement BDD testing framework"
|
||||
```
|
||||
|
||||
### Bug Fix
|
||||
```bash
|
||||
git commit -m "🐛 fix: resolve port conflict in test server"
|
||||
git commit -m "🐛 fix: handle JSON escaping in feature files"
|
||||
```
|
||||
|
||||
### Documentation
|
||||
```bash
|
||||
git commit -m "📝 docs: add comprehensive BDD testing guide"
|
||||
git commit -m "📝 docs: update AGENTS.md with commit conventions"
|
||||
```
|
||||
|
||||
### Refactoring
|
||||
```bash
|
||||
git commit -m "♻️ refactor: move log setup to config package"
|
||||
git commit -m "♻️ refactor: improve step pattern matching"
|
||||
```
|
||||
|
||||
### Tests
|
||||
```bash
|
||||
git commit -m "🧪 test: add BDD scenarios for greet service"
|
||||
git commit -m "🧪 test: implement health endpoint validation"
|
||||
```
|
||||
|
||||
### Configuration
|
||||
```bash
|
||||
git commit -m "🔧 chore: add log output file configuration"
|
||||
git commit -m "🔧 chore: update build system scripts"
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
### Commit Message Structure
|
||||
```
|
||||
<gitmoji> <type>: <description>
|
||||
|
||||
<optional body with details>
|
||||
|
||||
<optional footer with references>
|
||||
```
|
||||
|
||||
### Examples
|
||||
|
||||
**Simple commit:**
|
||||
```
|
||||
✨ feat: add skill_creator framework
|
||||
```
|
||||
|
||||
**Detailed commit:**
|
||||
```
|
||||
✨ feat: implement BDD testing with Godog
|
||||
|
||||
- Add features/greet.feature and features/health.feature
|
||||
- Implement step definitions in pkg/bdd/steps/
|
||||
- Create hybrid in-process test server
|
||||
- Add comprehensive documentation
|
||||
|
||||
Generated by Mistral Vibe.
|
||||
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
|
||||
```
|
||||
|
||||
**Complex commit:**
|
||||
```
|
||||
🧪 test: add comprehensive BDD test suite
|
||||
|
||||
- Implement greet service scenarios
|
||||
- Add health endpoint validation
|
||||
- Create test server on port 9191
|
||||
- Ensure no undefined/pending steps
|
||||
|
||||
Resolves: #42
|
||||
Ref: AGENTS.md
|
||||
Generated by Mistral Vibe.
|
||||
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
|
||||
```
|
||||
|
||||
## Validation
|
||||
|
||||
### Check Commit Message Format
|
||||
```bash
|
||||
# Verify gitmoji is present
|
||||
echo "$commit_message" | grep -E "^[[:space:]]*[🎨✨🐛📝🔧♻️🚀🔒📦🔥🐧🍎🪟🤖🧪📈🌐⚡]"
|
||||
|
||||
# Verify type: description format
|
||||
echo "$commit_message" | grep -E "^[🎨✨🐛📝🔧♻️🚀🔒📦🔥🐧🍎🪟🤖🧪📈🌐⚡][[:space:]]+[a-z_]+:"
|
||||
```
|
||||
|
||||
### Common Validation Issues
|
||||
|
||||
| Issue | Cause | Solution |
|
||||
|-------|-------|----------|
|
||||
| Missing gitmoji | No emoji at start | Add appropriate gitmoji from reference |
|
||||
| Wrong type | Type doesn't match emoji | Use correct type from reference table |
|
||||
| Missing colon | No colon after type | Add colon: `feat:` not `feat` |
|
||||
| Long first line | First line > 50 chars | Keep first line concise, add details in body |
|
||||
|
||||
## References
|
||||
|
||||
- [Gitmoji Official Site](https://gitmoji.dev)
|
||||
- [Common Gitmoji Reference in AGENTS.md](#common-gitmoji-reference)
|
||||
- [Conventional Commits](https://www.conventionalcommits.org/)
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Finding the Right Gitmoji
|
||||
```bash
|
||||
# Search for appropriate gitmoji
|
||||
grep "feature\|new" .vibe/skills/commit_message/SKILL.md
|
||||
# Result: ✨ :sparkles: feat - New feature
|
||||
```
|
||||
|
||||
### Commit Message Too Long
|
||||
```bash
|
||||
# Split into concise first line + detailed body
|
||||
git commit -m "✨ feat: add BDD framework" -m "- Implement Godog testing" -m "- Add greet/health features" -m "- Create test server"
|
||||
```
|
||||
|
||||
### Multiple Changes in One Commit
|
||||
```bash
|
||||
# Use comprehensive description
|
||||
git commit -m "♻️ refactor: improve BDD implementation" -m "- Update step patterns to match Godog exactly" -m "- Add JSON response validation" -m "- Implement server verification" -m "- Update all templates and documentation"
|
||||
```
|
||||
|
||||
## Assets
|
||||
|
||||
- **gitmoji-cheatsheet.md**: Quick reference for common gitmoji
|
||||
- **commit-template.txt**: Git commit message template
|
||||
- **validate-commit.sh**: Commit message validation script
|
||||
Reference in New Issue
Block a user