เกี่ยวกับ ตัวสร้างข้อความ Conventional Commit — คู่มือการใช้งาน
เครื่องมือสร้างข้อความคอมมิตแบบมาตรฐาน (Conventional Commit Generator) ช่วยสร้างข้อความคอมมิตของ Git ที่มีโครงสร้างถูกต้องตามข้อกำหนด Conventional Commits โดยจะแนะนำนักพัฒนาในการเลือก Type, Scope, บรรทัด Subject, คำอธิบายเพิ่มเติมในส่วน Body และการอ้างอิง Issue ในส่วน Footer
ทำเครื่องหมายการเปลี่ยนแปลงที่มีผลกระทบรุนแรง (breaking changes) ได้ง่ายๆ ด้วยไวยากรณ์เครื่องหมายอัศเจรีย์ (`type!: description`), อ้างอิง Issue ที่ปิดไป (`Closes #123`) และสร้างข้อความคอมมิตที่เป็นมาตรฐาน ซึ่งช่วยสนับสนุนเครื่องมืออัตโนมัติอย่าง `semantic-release` และระบบสร้างบันทึกการเปลี่ยนแปลง (changelog) อัตโนมัติ
คุณสมบัติและความสามารถหลัก
- มีแคตตาล็อกประเภทคอมมิตครบถ้วน: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
- ช่องระบุ scope ทางเลือก พร้อมคำแนะนำแบบเรียลไทม์สำหรับความยาวของ subject และการใช้ประโยคคำสั่ง (imperative phrasing)
- ปุ่มเปิด/ปิด Breaking Change ในคลิกเดียว พร้อมใส่ไวยากรณ์เครื่องหมายอัศเจรีย์ (`!`) ตามมาตรฐาน
- สร้างส่วนท้าย (footer) สำหรับเชื่อมโยงกับ issue โดยอัตโนมัติ พร้อมคัดลอกคำสั่ง `git commit -m` ได้ในคลิกเดียว
วิธีใช้งาน
- 1
เลือกประเภทของคอมมิต (เช่น `feat` สำหรับฟีเจอร์ใหม่, `fix` สำหรับการแก้ไขข้อผิดพลาด)
- 2
ระบุขอบเขต (scope) หากต้องการ (เช่น `api`, `auth`) และเขียนคำอธิบายสั้นๆ กระชับในเชิงคำสั่ง
- 3
ตรวจสอบข้อความคอมมิตที่ประกอบขึ้น และคัดลอกคำสั่ง `git commit` ฉบับเต็มเพื่อนำไปใช้ในเทอร์มินัลของคุณ
ตัวอย่างการใช้งานทั่วไป
- → ฝึกอบรมและสร้างข้อตกลงร่วมกันในทีมวิศวกรเพื่อสร้างประวัติการคอมมิตของ Git ที่มีมาตรฐานสม่ำเสมอ
- → ปรับเพิ่มเลขเวอร์ชันตามหลัก Semantic Versioning และสร้างบันทึกการเปิดตัวเวอร์ชันใหม่โดยอัตโนมัติร่วมกับไปป์ไลน์ CI/CD
- → ส่งสัญญาณแจ้งการเปลี่ยนแปลงที่เข้ากันไม่ได้กับเวอร์ชันเก่า (breaking changes) ของ API ระหว่างการอัปเดตไลบรารีครั้งใหญ่
เครื่องมือที่เกี่ยวข้อง
ตัวสร้าง Meta Tags สำหรับ SEO
สร้างแท็ก Open Graph, Twitter Cards และ SEO Meta Tags สำหรับเว็บไซต์
ตัวสร้าง .gitignore
สร้างไฟล์ .gitignore มาตรฐานสำหรับภาษา โปรแกรมแก้ไข และเฟรมเวิร์กต่างๆ
ตัวสร้างสัญญาอนุญาตโอเพนซอร์ส
สร้างไฟล์ LICENSE โอเพนซอร์สมาตรฐาน (MIT, Apache 2.0, GPLv3, BSD, ISC)
ตัวสร้างไฟล์ README
สร้างโครงร่างเอกสาร README.md ระดับมืออาชีพสำหรับโปรเจกต์ GitHub พร้อมแบดจ์
เครื่องคำนวณ Semantic Versioning
เปรียบเทียบเวอร์ชัน ตรวจสอบช่วงเงื่อนไข (Range) และเพิ่มเวอร์ชัน Major/Minor/Patch
ตัวดูและทดสอบ OpenAPI / Swagger
เรนเดอร์เอกสารสเปก OpenAPI/Swagger (YAML/JSON) เป็นหน้าต่างเอกสารแบบโต้ตอบ
คำถามที่พบบ่อยและความเป็นส่วนตัว
ประเภทของคอมมิตแต่ละแบบส่งผลต่อการปรับเพิ่มเลข Semantic Versioning อย่างไร?
ตามข้อตกลงมาตรฐานของ Conventional Commits นั้น `fix` จะปรับเพิ่มเวอร์ชันระดับ PATCH, `feat` จะปรับเพิ่มเวอร์ชันระดับ MINOR และคอมมิตใดๆ ที่มี `BREAKING CHANGE` จะปรับเพิ่มเวอร์ชันระดับ MAJOR
บรรทัด Subject ควรลงท้ายด้วยเครื่องหมายจุด (มหัพภาค) หรือไม่?
ไม่ควร แนวทางปฏิบัติที่ดีที่สุดของ Conventional Commits แนะนำให้เขียนประโยคคำสั่งที่กระชับโดยไม่ต้องใส่เครื่องหมายจุดปิดท้าย (เช่น `feat: allow user avatar upload`)