Minimal Vibe Coding Kit

Mô tả ngắn:

Cài một lần. Sáu công cụ AI coding dùng chung một bộ quy tắc và kiểm tra an toàn, cho mọi dự án.

Giới thiệu sản phẩm:

Minimal Vibe Coding Kit là một bộ file. Bạn thêm nó vào dự án một lần. Bộ file này cho công cụ AI coding biết dự án của bạn chạy thế nào và cần làm việc an toàn ra sao.

Công cụ AI coding là chương trình viết code giúp bạn. Claude Code và Cursor là hai ví dụ. Kit hỗ trợ sáu công cụ: Claude Code, Cursor, Codex, OpenCode, Grok và Kimi Code. Kit dùng được với mọi ngôn ngữ lập trình.

Vì sao nên dùng:

- Công cụ AI viết code rất nhanh, nhưng có thể đoán sai. Nó có thể sửa quá nhiều file. Nó có thể quên quy tắc của bạn ở phiên làm việc mới.

- Kit đưa cho công cụ một bản đồ dự án và các giới hạn rõ ràng. Bạn nhận kết quả tốt hơn và ít thay đổi ngoài ý muốn.

Cách hoạt động (khoảng 2 phút):

1. Cài kit bằng một lệnh (xem mục "Cài đặt" bên dưới).

2. Mở dự án trong công cụ AI coding của bạn. Dán một prompt.

3. Đọc các thay đổi mà công cụ đề xuất. Trả lời "yes" để đồng ý.

Sau đó công cụ ghi file backbone.yml. File này là bản đồ dự án. Công cụ đọc nó ở đầu mỗi phiên làm việc.

Trong kit có gì:

- Rules (quy tắc): các giới hạn ngắn mà công cụ luôn đọc.

- Skills: các quy trình làm việc viết sẵn. Công cụ chỉ nạp một skill khi tác vụ cần. Kit có 26 skills.

- Commands (lệnh): các từ ngắn như /security-scan để chạy nhanh những skill hay dùng.

- backbone.yml: một bản đồ dự án chung cho cả sáu công cụ.

Các skill nên thử trước:

Làm rõ yêu cầu

- prompt-sharpener: biến một ý tưởng thô thành yêu cầu chính xác, rồi thực hiện luôn.

- clearthought và sequential-thinking: chia tác vụ lớn hoặc mơ hồ thành các bước nhỏ mà bạn có thể kiểm tra.

Làm việc có kiểm tra

- clean-delivery: làm một thay đổi nhỏ qua sáu bước: specify (đặc tả), code, clean (dọn dẹp), architect (kiểm tra cấu trúc), harden (làm chắc) và verify (xác minh). Mỗi bước phải qua kiểm tra thì mới sang bước sau.

- proofline-orchestration: dùng các AI có vai trò riêng. Một AI viết code. Một AI khác tìm lỗi của kết quả. Bài test quyết định việc đã xong hay chưa.

- parallel-analysis: chạy 2 đến 5 lượt phân tích chỉ đọc (không sửa file) cùng lúc, rồi gộp và xác minh kết quả. Hợp với thay đổi lớn và câu hỏi về cả dự án.

- autoresearch-coding: thử từng thay đổi nhỏ một. Chỉ giữ thay đổi nào làm một con số do bạn chọn tốt hơn.

Giữ dự án an toàn

- agentshield-security-review: kiểm tra các file cấu hình AI (rules, skills, hooks và MCP) trước khi merge. Nó tìm các rủi ro như prompt injection.

- threat-model-security-review: rà soát code ứng dụng (API, đăng nhập, đường nhập dữ liệu) để tìm rủi ro bảo mật. Nó báo điều đã tìm thấy và điều chưa chứng minh được.

- path-sensitive-shell-safety: kiểm tra các shell script có dùng đường dẫn file. Nó bảo đảm một đường dẫn rỗng hoặc quá rộng không bao giờ chạm tới lệnh rm.

Hỗ trợ hằng ngày

- coding-level: chọn mức giải thích từ 0 (rất đơn giản) đến 5 (chuyên gia). Kit giữ lựa chọn của bạn cho các phiên sau.

- memento: lưu ghi chú ở cuối phiên làm việc để phiên sau làm tiếp.

- wait-what: dùng khi một câu trả lời chưa rõ. Công cụ giải thích lại bằng ngôn ngữ đơn giản, theo ngôn ngữ của bạn.

- mermaid: vẽ sơ đồ quy trình và hệ thống.

Kit còn 12 skill khác, ví dụ clone-website, visual-design-loop và daily-workflow-curator. Xem danh sách đầy đủ trên GitHub.

An toàn có sẵn:

- Kit không ghi đè file CLAUDE.md hoặc AGENTS.md của bạn. Nó chỉ thêm một khối có đánh dấu.

- Mọi thay đổi khi cài đặt đều chờ bạn đồng ý.

- Bạn có thể liệt kê các đường dẫn được bảo vệ trong backbone.yml. Công cụ không sửa chúng khi chưa có sự đồng ý của bạn.

- Công cụ xóa file bằng lệnh trash, không dùng rm. Bạn có thể đưa file đã xóa trở lại. Xóa vĩnh viễn cần bạn đồng ý.

- Kiểm tra bảo mật các file cấu hình AI là một phần của quy trình thường ngày.

Cài đặt (cần Node.js 18 trở lên):

npx --yes minimal-vibe-coding-kit@latest install /path/to/your-project

Thay /path/to/your-project bằng đường dẫn tới thư mục dự án của bạn. Muốn cài cho một vài công cụ thôi, thêm --profile, ví dụ --profile claude,cursor.

Sau đó mở dự án trong công cụ AI coding và dán prompt này (giữ nguyên tiếng Anh):

Read .vibekit/init/FIRST_TIME_INIT.md and initialize this repo with Minimal Vibe Coding Kit. First print the requirements you will check. Then run detection, propose one diff for backbone.yml and managed instruction blocks, and wait for my yes before writing.

Cập nhật khi có bản mới: