Quy tắc viết Changelog

Làm được gì

• Định nghĩa khung chuẩn của CHANGELOG.md: phần mở đầu, mục [Unreleased], các liên kết so sánh phiên bản ở cuối file.
• Phân biệt thay đổi nên và không nên ghi: bỏ refactor, format code, CI/CD, cập nhật tài liệu, bump dependency không đổi hành vi; giữ tính năng mới, thay đổi hành vi, xoá/deprecate, sửa lỗi, bản vá bảo mật.
• Chuẩn hoá văn phong: động từ nguyên mẫu ở hiện tại, không dấu chấm cuối, mỗi thay đổi một bullet, ưu tiên động từ người dùng thấy được ("Add", "Fix", "Show", "Allow") thay vì "Implement", "Refactor".
• Kiểm tra thay đổi thực so với bản phát hành trước: dùng git show <tag>:<đường-dẫn> và git log --follow để xác nhận người dùng bản cũ có thấy khác biệt; gộp hoặc bỏ những mục chỉ sửa tính năng chưa từng phát hành.
• Thêm liên kết PR và issue theo thứ tự tăng dần, tìm issue liên quan bằng gh pr view <số> --json closingIssuesReferences.
• Quy định thứ tự nhóm (Added → Changed → Deprecated → Removed → Fixed → Security), ngày ISO 8601, và tự nhận biết tag có tiền tố v hay không.

Phù hợp với ai

• Maintainer dự án mã nguồn mở muốn changelog nhất quán giữa nhiều người đóng góp.
• Nhóm phát triển đã theo Keep a Changelog + SemVer nhưng văn phong mỗi người một kiểu.
• Người muốn tự xây lệnh /create-changelog, /update-changelog cho Claude Code.

Ví dụ sử dụng

1. Trước khi phát hành: soát mục Unreleased, phát hiện những mục "sửa lỗi của tính năng chưa ra mắt", gộp lại rồi chốt thành ## [1.3.0] - 2025-06-01.
2. Sau khi merge PR #142: tra issue liên quan #137 bằng gh và thêm - Fix crash on startup ([#137](...), [#142](...)) vào Unreleased/Fixed.
3. Dựng lại changelog từ các tag cũ: không có PR nên bỏ phần tham chiếu, sắp xếp ngược thời gian và sinh liên kết so sánh từ URL remote.

Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình:
https://raw.githubusercontent.com/tobihagemann/turbo/HEAD/claude/skills/changelog-rules/SKILL.md

Mình muốn: (viết việc bạn cần ở đây)

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục claude/skills/changelog-rules từ repo GitHub tobihagemann/turbo vào ~/.claude/skills/changelog-rules/ của mình.
Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.