Version Release (chuẩn hoá semantic versioning)

Skill giúp chọn đúng mức tăng phiên bản theo semver rồi đồng bộ mọi nơi ghi version trong repo cùng milestone GitHub.

Lập trìnhNâng cao★ 971⑂ 225Điểm AI 8/10Cập nhật lần cuối: 4 thg 9, 2026

Skill này làm gì

Phân loại thay đổi thành patch / minor / major kèm lý do; nếu ranh giới mơ hồ thì chọn mức cao hơn hoặc hỏi lại người dùng.
Cập nhật toàn bộ "bề mặt" chứa phiên bản: package/lockfile gốc và desktop, OpenAPI, image tag trong docker-compose.yml, Helm chart (version, appVersion), nhãn/image/kustomize newTag trong deployments/kubernetes/**, deploy.sh, tài liệu triển khai, CITATION.cff, và dòng UI build v<version>.
Dùng server/__tests__/release-version-consistency.test.js làm hợp đồng phát hành: đọc trước khi bump, chạy lại sau khi bump.
Quét phiên bản cũ bằng grep -F (tránh dấu chấm bị hiểu là regex) để đảm bảo không còn sót.
Tạo hoặc tái dùng milestone v<version> qua gh, gán cho PR hiện tại và các issue được liên kết, rồi đọc lại để xác minh.
Cấm rõ ràng việc bump các package phát hành độc lập (client, mcp, monitoring, vscode-extension), cache service worker, và cấm tạo/di chuyển Git tag khi chưa được phê duyệt.

Phù hợp với ai

Nhóm làm monorepo có version rải rác ở code, Helm chart, manifest Kubernetes và tài liệu.
Maintainer muốn tự động hoá phần "giấy tờ" phát hành: milestone, issue liên kết, kiểm tra nhất quán.
Người dùng repo CCAM, hoặc muốn lấy checklist này làm mẫu cho quy trình release của mình.

Ví dụ sử dụng

"PR này thêm một trang dashboard mới" → skill kết luận minor, giải thích lý do và cập nhật đồng loạt package, Helm, k8s, tài liệu rồi chạy test nhất quán.
"Mình chỉ vá lỗi bảo mật của dependency" → kết luận patch, sau đó quét grep -F phiên bản cũ và báo số lần xuất hiện còn lại.
"Dọn milestone phát hành đi" → truy vấn toàn bộ milestone qua gh api; nếu v2.1.0 đang mở thì tái dùng, nếu đã đóng hoặc trùng lặp thì dừng và báo cáo.

· · · 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/hoangsonww/Claude-Code-Agent-Monitor/HEAD/.agents/skills/version-release/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.

↓ 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 Claude Skill Mart.
Copy thư mục .agents/skills/version-release từ repo GitHub hoangsonww/Claude-Code-Agent-Monitor vào ~/.claude/skills/version-release/ 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/hoangsonww/Claude-Code-Agent-Monitor.git /tmp/ccam && mkdir -p ~/.claude/skills && cp -r /tmp/ccam/.agents/skills/version-release ~/.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.
Clone repo về thư mục tạm: git clone https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git /tmp/ccam
Tạo thư mục skill: mkdir -p ~/.claude/skills
Copy skill: cp -r /tmp/ccam/.agents/skills/version-release ~/.claude/skills/
Kiểm tra file references/version-checklist.md đã được copy kèm.
Cài và đăng nhập GitHub CLI: gh --version rồi gh auth status (bắt buộc cho bước milestone).
Khởi động lại Claude Code và thử yêu cầu: "chuẩn bị release, tăng phiên bản giúp mình".
Nếu dùng cho repo khác, hãy sửa các đường dẫn file, image tag và đường dẫn test trong SKILL.md cho phù hợp.

Xem mã nguồn trên GitHub ↗Giấy phép: MIT