Changelog (phát hành Ratel)
Skill chuyên dụng cập nhật CHANGELOG.md theo từng release unit của monorepo Ratel: tạo bản nháp bằng git-cliff, cho người dùng duyệt, rồi ghi file.
Lập trìnhNâng cao★ 420⑂ 20Điểm AI 7/10Cập nhật lần cuối: 11 thg 8, 2026
Làm được gì
- Cập nhật
CHANGELOG.mdcủa một release unit (core, sdk-ts, sdk-py, telemetry-*, vercel-ai-sdk, mastra) trước khi gắn tag phát hành. - Đọc phiên bản chuẩn và tiền tố tag qua
scripts/release-units.mjs, tính khoảng diff từ tag cuối của chính unit đó đến HEAD. - Sinh bản nháp theo chuẩn Keep-a-Changelog bằng
.claude/skills/changelog/draft.sh(bọc git-cliff), để người dùng biên tập rồi chỉ sửa file bằng Edit tool (không commit). - Với bản RC: thêm section mới lên đầu. Với bản GA: gộp toàn bộ section
X.Y.Z-rc.*cùng số hiệu thành một sectionX.Y.Z, khử trùng lặp bullet.
Phù hợp với ai
- Maintainer thực sự phát hành trong repo ratel-ai/ratel.
- Nhóm quản lý monorepo có tag/phiên bản riêng cho từng package và cổng CI kiểm tra CHANGELOG — dùng để tham khảo thiết kế.
Ví dụ sử dụng
- "Chuẩn bị phát hành sdk-ts 0.2.0-rc.3" → tạo nháp và thêm
## [0.2.0-rc.3] - YYYY-MM-DDvàosrc/sdk/ts/CHANGELOG.md. - "Lên GA 0.3.0 cho core" → gộp các section rc.1–rc.4 thành một section
## [0.3.0]duy nhất. - "Unit nào đang có thể phát hành?" → chạy
node scripts/releasable.mjs, chọn unit rồi lặp lại quy trình cho từng unit.
· · · 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 Claude 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 skill:
mkdir -p ~/.claude/skills - Copy skill:
cp -r ratel/.claude/skills/changelog ~/.claude/skills/- Lưu ý: skill phụ thuộc vào
scripts/vàdraft.shcủa repo Ratel, nên tốt nhất hãy chạy Claude Code ngay trong repo Ratel.
- Lưu ý: skill phụ thuộc vào
- Cài git-cliff:
cargo install git-cliff(hoặcbrew install git-cliff); nếu thiếu,draft.shsẽ thoát với mã 127. - Chạy Claude Code tại thư mục gốc repo và yêu cầu: "dùng skill changelog để chuẩn bị phát hành <unit>".
- Xem lại bản nháp, chỉnh sửa và xác nhận; skill chỉ sửa CHANGELOG, còn commit và tag bạn tự làm.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT