אודות מחולל הודעות Conventional Commits — מדריך מפורט
מחולל הודעות ה-Conventional Commit בונה הודעות Git commit מובנות התואמות למפרט ה-Conventional Commits. הוא מדריך מפתחים בבחירת הסוג (Type), ההיקף (Scope), שורת הנושא (Subject), תיאור הגוף (Body) האופציונלי והכותרת התחתונה (Footer) לקישור בעיות.
סמן בקלות שינויים שוברי תאימות באמצעות תחביר סימן הקריאה (`type!: description`), קשר בעיות שנסגרו (`Closes #123`), והפק הודעות commit סטנדרטיות המאפשרות שילוב עם כלים אוטומטיים כמו `semantic-release` ומחוללי יומן שינויים (changelog) אוטומטיים.
תכונות ויכולות עיקריות
- קטלוג סוגים מלא: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
- הזנת היקף (scope) אופציונלית ותזכורות בזמן אמת לאורך שורת הנושא ולניסוח בלשון ציווי
- מתג Breaking Change בלחיצה אחת המחיל את תחביר סימן הקריאה הסטנדרטי (`!`)
- מחולל כותרת תחתונה אוטומטי לקישור בעיות עם העתקה בלחיצה אחת של `git commit -m`
כיצד להשתמש
- 1
בחר את סוג ה-commit (לדוגמה `feat` עבור תכונות חדשות, `fix` עבור תיקוני באגים).
- 2
הזן היקף אופציונלי (למשל `api`, `auth`) ותיאור תמציתי בלשון ציווי.
- 3
בדוק את מחרוזת ה-commit שהורכבה והעתק את פקודת ה-`git commit` המלאה למסוף שלך.
שימושים נפוצים
- ← הטמעת סטנדרטים עקביים של היסטוריית Git commit בקרב צוותי הנדסה
- ← אוטומציה של העלאת גרסאות סמנטיות והפקת הערות שחרור אוטומטיות בצינורות CI/CD
- ← סימון שינויים שוברי תאימות לאחור (breaking changes) ב-API במהלך עדכוני גרסה ראשיים של ספריות
כלים קשורים
מחולל תגיות Meta (SEO)
יצירת תגיות מטא מלאות עבור Open Graph, Twitter Cards ותגיות SEO בסיסיות.
מחולל .gitignore
יצירת קובצי .gitignore מותאמים אישית לשפות פיתוח, סביבות עבודה ומערכות הפעלה.
מחולל רישיונות קוד פתוח
יצירת קובצי רישיון פופולריים (MIT, Apache 2.0, GPL v3, BSD) עם פרטי הפרויקט.
מחולל README.md
יצירת תבנית README מקיפה ומעוצבת לפרויקטים בקוד פתוח עם סמלילים ותיאורים.
מחשבון גרסאות SemVer
חישוב ובדיקת גרסאות סמנטיות (Semantic Versioning), טווחי תאימות ושדרוגים.
מציג מפרטי OpenAPI / Swagger
תצוגה מקדימה, ניווט ואינטראקציה עם מסמכי API בפורמט OpenAPI ו-Swagger (JSON/YAML).
שאלות נפוצות ופרטיות
איזו העלאת גרסה סמנטית תואמת לכל סוג commit?
לפי מוסכמות Conventional Commits המקובלות, `fix` מפעיל העלאת PATCH, `feat` מפעיל העלאת MINOR, וכל commit הכולל `BREAKING CHANGE` מפעיל העלאת MAJOR.
האם שורת הנושא צריכה להסתיים בנקודה?
לא. שיטות העבודה המומלצות של Conventional Commits ממליצות על משפט ציווי תמציתי ללא נקודה בסופו (למשל `feat: allow user avatar upload`).