AI Skill MartKhám phá skillLệnhChương trìnhHọcSkill là gì?
← Về danh sách

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 trong release.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

  1. "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.
  2. "Nâng core lên GA" → gộp các mục 0.3.0-rc.1..rc.4 thành ## [0.3.0] - 2025-01-20, bỏ bullet trùng.
  3. "Đơ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)
  1. Tải tệp ZIP bằng nút bên dưới.
  2. Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
  3. Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
↓ Tải ZIP
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.

  1. Mở terminal và clone repo: git clone https://github.com/ratel-ai/ratel.git
  2. Tạo thư mục kỹ năng: mkdir -p ~/.claude/skills
  3. Sao chép kỹ năng: cp -r ratel/.claude/skills/changelog ~/.claude/skills/
  4. Cài git-cliff (bắt buộc cho draft.sh): cargo install git-cliff hoặc brew install git-cliff
  5. Vì kỹ năng gọi scripts/release-units.mjs, scripts/releasable.mjs và cliff.toml, hãy chạy Claude Code ngay tại thư mục gốc của repo Ratel.
  6. Trong Claude Code, yêu cầu ví dụ: "Dùng skill changelog để chuẩn bị release cho sdk-ts".