MVCK Premium

Hướng dẫn: đưa kit vào dự án của bạn

Chọn lối đi hợp với bạn. Ở cả hai lối, cách dễ nhất là nhờ công cụ AI làm giúp.

Người mới

Bạn không cần gõ lệnh. Bạn dán một câu cho AI, rồi trả lời có hoặc không.

Lối người mới

Dev

Bạn tự chạy từng lệnh. Mỗi bước có lệnh để chép và kết quả đúng để so.

Lối dev

Lối người mới: nhờ AI cài giúp

Dùng được với Cursor, Claude Code, Codex, OpenCode, Grok và Kimi. Dev cũng nên bắt đầu ở đây.

Người Nói Dễ Hiểu

Bạn chỉ làm 4 việc nhỏ. Việc khó để AI lo.

  1. Để hai file vừa tải vào thư mục Tải về

    Sau khi mua, bạn tải về hai file. Để hai file cạnh nhau.

    minimal-vibe-coding-kit-premium-0.6.6.tgzSHA256SUMS

  2. Mở dự án của bạn trong công cụ AI

    Mở thư mục dự án bằng công cụ bạn đang dùng. Kit không cài công cụ AI và không đăng nhập giúp bạn.

    • Claude Code
    • Codex
    • Cursor
    • OpenCode
    • Grok
    • Kimi

  3. Dán câu này vào khung chat của AI

    Đổi đường dẫn nếu file của bạn nằm ở chỗ khác.

    Đường dẫn ~/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz chỉ là ví dụ. Hãy đổi thành nơi bạn đã lưu file.

    Cách lấy đúng đường dẫn file của bạn

    1. Mở File Explorer và chọn file vừa tải.
    2. Nhấn Ctrl + Shift + C. Trên Windows 10: giữ Shift, bấm chuột phải vào file, rồi chọn "Copy as path".
    3. Dán đường dẫn vào chỗ đường dẫn ví dụ.

    Đường dẫn có dạng như sau:

    C:\Users\<name>\Downloads\minimal-vibe-coding-kit-premium-0.6.6.tgz

    Trên Windows, hãy viết đường dẫn thư mục đầy đủ thay cho ~ trong các lệnh ở trang này.

    Câu dán cho AI: cài mới

    Tôi đã mua Minimal Vibe Coding Kit Premium. File nằm ở: ~/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz Hãy cài kit vào dự án đang mở. Làm từng bước và báo kết quả mỗi bước. 1. Tính SHA-256 của file. So với file SHA256SUMS cùng thư mục. Nếu khác thì dừng. 2. Giải nén vào ~/tools/mvck-0.6.6. Không giải nén vào dự án. 3. Vào thư mục package vừa giải nén. Chạy lệnh xem trước: node bin/mvck.js install "<đường dẫn dự án này>" --profile all --dry-run --json Nói cho tôi biết lệnh sẽ thêm gì. 4. Chờ tôi trả lời yes. Sau đó chạy lại lệnh, bỏ --dry-run --json. 5. Đọc .vibekit/init/FIRST_TIME_INIT.md và khởi tạo dự án. Cho tôi xem bản đề xuất backbone.yml. Chờ tôi duyệt rồi mới ghi. 6. Chạy doctor và validate của kit trong dự án. Báo kết quả bằng lời dễ hiểu.

  4. Đọc và trả lời AI

    AI dừng lại hai lần để hỏi bạn: trước khi chép kit vào dự án, và trước khi lưu bộ luật của dự án. Bạn đọc rồi trả lời yes.

    Kết quả đúng:Validation summary: 0 failures, 0 warnings.

  5. Đã có kit, muốn lên bản mới?

    Tải bản mới, rồi dán câu này. AI xem trước thay đổi, sao lưu file cũ của kit, rồi mới cập nhật.

    Câu dán cho AI: cập nhật

    Tôi vừa tải bản mới của Minimal Vibe Coding Kit Premium. File nằm ở: ~/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz Dự án đang mở đã có kit. Hãy cập nhật. Làm từng bước và báo kết quả mỗi bước. 1. Tính SHA-256 của file. So với SHA256SUMS. Nếu khác thì dừng. 2. Giải nén vào ~/tools/mvck-0.6.6, tách khỏi dự án. 3. Vào thư mục package của bản mới. Chạy lệnh xem trước: node bin/mvck.js update "<đường dẫn dự án này>" --profile all --dry-run --json Cho tôi biết fromVersion, toVersion và số file sẽ đổi. 4. Chờ tôi trả lời yes. Sau đó chạy lại lệnh, bỏ --dry-run --json. 5. Chạy git status trong dự án. Nói cho tôi file nào đã đổi và bản sao lưu nằm ở đâu. 6. Chạy doctor và validate của kit. Báo kết quả.

Lối dev: tự chạy từng lệnh

Đã chạy thử trên macOS với Node 22 và gói 0.6.6. Kit cần Node 18 trở lên.

Người Thợ Cẩn Thận

Bảy bước. Xem trước rồi mới ghi.

  1. Kiểm tra file tải về

    So chuỗi in ra với dòng trong SHA256SUMS. Nếu khác thì tải lại.

    Đường dẫn ~/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz chỉ là ví dụ. Hãy đổi thành nơi bạn đã lưu file.

    Cách lấy đúng đường dẫn file của bạn

    1. Mở File Explorer và chọn file vừa tải.
    2. Nhấn Ctrl + Shift + C. Trên Windows 10: giữ Shift, bấm chuột phải vào file, rồi chọn "Copy as path".
    3. Dán đường dẫn vào chỗ đường dẫn ví dụ.

    Đường dẫn có dạng như sau:

    C:\Users\<name>\Downloads\minimal-vibe-coding-kit-premium-0.6.6.tgz

    Trên Windows, hãy viết đường dẫn thư mục đầy đủ thay cho ~ trong các lệnh ở trang này.

    Lệnh
    cd ~/Downloads
node -e "console.log(require('node:crypto').createHash('sha256').update(require('node:fs').readFileSync(process.argv[1])).digest('hex'))" minimal-vibe-coding-kit-premium-0.6.6.tgz
cat SHA256SUMS

    Kết quả đúng:Hai chuỗi 64 ký tự giống nhau

  2. Giải nén ra thư mục riêng

    Giữ kit tách khỏi dự án của bạn. Thư mục package chứa bin/mvck.js.

    Lệnh
    mkdir -p ~/tools/mvck-0.6.6
tar -xzf minimal-vibe-coding-kit-premium-0.6.6.tgz -C ~/tools/mvck-0.6.6
cd ~/tools/mvck-0.6.6/package
node bin/mvck.js --help

    Kết quả đúng:Minimal Vibe Coding Kit Premium

  3. Xem trước, chưa ghi gì

    Đổi đường dẫn thành dự án của bạn. Chọn profile theo công cụ AI bạn dùng, hoặc dùng all.

    Profile:

    Bấm chọn một mục: lệnh ở bước 3, 4 và 7 đổi theo.

    Lệnh
    node bin/mvck.js install "/path/to/project" --profile all --dry-run --json

    Kết quả đúng:"status": "dry-run"

  4. Cài vào dự án

    Lệnh này ghi ngay. Nếu dự án đã có CLAUDE.md hoặc AGENTS.md, kit chỉ thêm khối do kit quản lý.

    Lệnh
    node bin/mvck.js install "/path/to/project" --profile all

    Kết quả đúng:Install complete:

  5. Khởi tạo bộ luật của dự án

    Mở dự án trong công cụ AI và dán câu này vào khung chat. AI đọc dự án, đề xuất backbone.yml, rồi chờ bạn duyệt.

    Câu dán cho AI

    Read .vibekit/init/FIRST_TIME_INIT.md and initialize this project with the kit. Print the requirements you will check. Propose a diff for backbone.yml. Wait for my approval before you write. Summarize in Vietnamese.

    Kết quả đúng:AI đưa ra bản đề xuất backbone.yml và chờ bạn duyệt

  6. Kiểm tra

    Chạy trong thư mục dự án. doctor báo tình trạng, validate kiểm luật của kit.

    Lệnh
    cd "/path/to/project"
node .vibekit/scripts/mvck.mjs doctor .
node .vibekit/scripts/mvck.mjs validate .

    Kết quả đúng:Validation summary: 0 failures, 0 warnings.

  7. Cập nhật lên bản mới

    Tải bản mới và giải nén ra thư mục riêng. Chạy từ thư mục package của bản mới. File kit bị thay được sao lưu ở .vibekit/update-backup/.

    Lệnh
    node bin/mvck.js update "/path/to/project" --profile all --dry-run --json
node bin/mvck.js update "/path/to/project" --profile all

    Kết quả đúng:Update complete:

Khi gặp lỗi

Vẫn kẹt? Gửi email cho tác giả: [email protected]. Đừng gửi mật khẩu hay khóa bí mật.

Chưa có kit?

Bản đang bán: v0.6.6. Xem bản này có gì mới trong change logs.

Mua kitXem change logs