Phát hành phiên bản (publish-release)
Quy trình phát hành npm đầy đủ: kiểm tra cục bộ → đẩy tag → GitHub Actions publish có phê duyệt → xác minh gói đã lên registry.
Tự động hóaNâng cao★ 119⑂ 7Điểm AI 7/10Cập nhật lần cuối: 21 thg 8, 2026
Giúp được gì
- Điều phối việc phát hành package
moi-computerlên npm. Mặc định là bản preview dưới dist-tagnext; thêmstableđể ra bảnlatestkèm GitHub release. - Các bước: tiền kiểm (cây git sạch, đang ở
main, đã đồng bộ, ghi lại trạng tháibun linktoàn cục) → chọn số phiên bản → kiểm tra cục bộ (lint, format, test,bun pm packrồi soi nội dung tarball và quét secret) → xin xác nhận người dùng → commit, tag, push. - Không bao giờ publish từ máy cá nhân: cấm
npm publishvànpm login; workflow GitHub Actions dùng trusted publishing (OIDC) và bị chặn bởi reviewer của môi trườngrelease. - Sau khi publish: kiểm tra dist-tags đã dịch chuyển đúng, kiểm tra provenance/attestations, cài thật để smoke test (
moi version,moi start, curl API), rồi hoàn nguyên môi trường dev (bun link, xóa tarball vàdist/).
Phù hợp với ai
- Người bảo trì repo molefrog/moi và thường xuyên ra bản phát hành.
- Ai muốn một mẫu runbook thực tế cho pipeline phát hành dựa trên tag + cổng phê duyệt thủ công.
- Ai muốn học cách viết hướng dẫn cho AI agent, trong đó ghi rõ cả những việc không được làm.
Ví dụ sử dụng
- "Ra một bản preview dev" → đọc dist-tags hiện tại, tính
X.Y.Z-next.Nphải sắp thứ tự cao hơnlatest, báo cáo kết quả kiểm tra rồi mới đẩy tag. - "Phát hành chính thức 0.4.0" → kiểm tra, đẩy tag, đưa link phê duyệt GitHub, theo dõi run, soạn release notes theo quy tắc ngôn ngữ sản phẩm và chạy
gh release create. - Khi run bị từ chối hoặc job verify thất bại → xóa tag ở cả local và remote để tái sử dụng đúng số phiên bản, sau đó phục hồi liên kết dev.
· · · 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/molefrog/moi/HEAD/.agents/skills/publish-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.
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/publish-release từ repo GitHub molefrog/moi vào ~/.claude/skills/publish-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/molefrog/moi.git && mkdir -p ~/.claude/skills && cp -r moi/.agents/skills/publish-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 và vào thư mục làm việc.
- Clone repo:
git clone https://github.com/molefrog/moi.git - Tạo thư mục skills:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r moi/.agents/skills/publish-release ~/.claude/skills/ - Skill này chỉ dành riêng cho repo moi, nên hãy chạy Claude Code bên trong repo đó. (Nếu bạn làm việc ngay trong repo thì
.agents/skillsđã có sẵn, không cần sao chép.) - Chuẩn bị:
bun,git, GitHub CLI (kiểm tra bằnggh auth status) và quyền phê duyệt môi trườngreleasetrên GitHub. - Trong Claude Code, yêu cầu "publish-release" hoặc "publish-release stable" để bắt đầu quy trình.
Xem mã nguồn trên GitHub ↗Giấy phép: NOASSERTION