Changelog (phát hành Ratel)
Kỹ năng cập nhật CHANGELOG.md theo từng gói trước khi gắn tag phát hành: tạo bản nháp bằng git-cliff, cho bạn biên tập, rồi ghi file.
Tự động hóaNâng cao★ 554⑂ 32Điểm AI 7/10Cập nhật lần cuối: 9 thg 11, 2026
Làm được gì
- Xác định đơn vị phát hành (core, sdk-ts, sdk-py, telemetry, adapters...), phiên bản hiện tại và khoảng diff từ tag phát hành gần nhất tới HEAD.
- Chạy
draft.sh(dựa trên git-cliff) để sinh bản nháp theo chuẩn Keep-a-Changelog (### Added/### Changed/### Fixed). - Với bản RC: chèn mục mới lên đầu. Với bản GA: gộp tất cả mục
X.Y.Z-rc.*thành một mục## [X.Y.Z]duy nhất và khử trùng lặp bullet. - Cùng bạn tinh chỉnh câu chữ, rồi chỉ ghi CHANGELOG của đúng đơn vị đó — không tự commit.
- Nhắc các bước tiếp theo: commit phát hành, tag
<unit>-vX.Y.Z, push và cổng kiểm tra phiên bản trongrelease.yml.
Dành cho ai
- Maintainer phụ trách phát hành trong monorepo Ratel (ratel-ai/ratel).
- Nhóm dùng monorepo với tag/phiên bản riêng cho từng gói, muốn tham khảo quy ước changelog.
- Kỹ sư release muốn thiết kế luồng "git-cliff sinh nháp + người duyệt".
Ví dụ sử dụng
- "Chuẩn bị phát hành sdk-ts 0.2.0-rc.3" → lấy commit từ tag
sdk-ts-v*gần nhất, thêm mục RC mới. - "Nâng core lên GA" → gộp các mục
0.3.0-rc.1..rc.4thành## [0.3.0] - 2025-01-20, bỏ bullet trùng. - "Đơn vị nào đang có thay đổi chưa phát hành?" → chạy
node scripts/releasable.mjsđể liệt kê.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/ratel-ai/ratel/HEAD/.claude/skills/changelog/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên AI Skill Mart. Copy thư mục .claude/skills/changelog từ repo GitHub ratel-ai/ratel vào ~/.claude/skills/changelog/ 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.
Cài bằng lệnh thủ công
git clone https://github.com/ratel-ai/ratel.git /tmp/ratel && mkdir -p ~/.claude/skills && cp -r /tmp/ratel/.claude/skills/changelog ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và clone repo:
git clone https://github.com/ratel-ai/ratel.git - Tạo thư mục kỹ năng:
mkdir -p ~/.claude/skills - Sao chép kỹ năng:
cp -r ratel/.claude/skills/changelog ~/.claude/skills/ - Cài git-cliff (bắt buộc cho
draft.sh):cargo install git-cliffhoặcbrew install git-cliff - Vì kỹ năng gọi
scripts/release-units.mjs,scripts/releasable.mjsvàcliff.toml, hãy chạy Claude Code ngay tại thư mục gốc của repo Ratel. - Trong Claude Code, yêu cầu ví dụ: "Dùng skill changelog để chuẩn bị release cho sdk-ts".
Xem mã nguồn trên GitHub ↗Giấy phép: MIT