Vibe Coding Harness – Agent kiểm định đầu ra
Skill 'cổng chất lượng' đọc harness.json rồi rà từng mục xem PRD, tài liệu dự án và các đầu ra khác có đúng chuẩn quản trị không, kèm hướng dẫn sửa lỗi.
Lập trìnhTrung cấp★ 168⑂ 1Điểm AI 8/10Cập nhật lần cuối: 30 thg 6, 2026
Làm được gì
- Đọc
harness.json(nguồn quy tắc duy nhất) vàCLAUDE.md, sau đó kiểm tra từng file trongdocs/. - Chuỗi kiểm tra: file có tồn tại/không rỗng → đủ mục bắt buộc → kiểm tra trường theo regex (ví dụ số phiên bản
v0.1) → kiểm tra nội dung (số chữ, từ khoá, định dạng checklist) → quét mục cấm (TODO,{placeholder}, chuỗi nghi là API keysk-...) → đối chiếu nhất quán giữa các skill (tên sản phẩm trong PRD vs trong tài liệu dự án) → cổng chất lượng cuối. - Ngoài đầu ra, nó còn audit quy trình: sổ tiến độ
docs/, thẻ tiến độ.dsu/progress/, phát hiện nhảy giai đoạn hoặc "hoàn thành giả" (sổ ghi xong nhưng đầu ra chưa đạt). - Báo cáo chia mức 🔴 lỗi / 🟡 cảnh báo / 🔵 gợi ý dưới dạng bảng, mỗi dòng kèm câu lệnh sửa có thể copy đưa lại cho AI. Tối đa 3 vòng sửa, sau đó đánh dấu "cần người can thiệp".
Phù hợp với ai
- Người đang dùng bộ vibe-coding-kit (các skill PRD, yêu cầu, kiến trúc, production...).
- Người muốn kiểm chứng máy móc thay vì tin lời AI nói "đã xong".
- Nhóm cần áp chuẩn tài liệu thống nhất cho toàn dự án.
Ví dụ sử dụng
- Sau khi skill viết PRD chạy xong: "kiểm định giúp mình" → liệt kê mục thiếu và lỗi định dạng phiên bản trong
docs/prd.md. - "Kiểm tra toàn bộ" → quét cả
docs/, phát hiện tên dự án trong PRD khác với tài liệu dự án (quy tắc CSR-003). - Giữa kỳ phát triển: phát hiện sổ tiến độ ghi đang ở S2 nhưng cổng ra S1 chưa qua → báo 🔴 vi phạm quy trình.
· · · 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/Junliu1066/vibe-coding-kit/HEAD/skills/vibe-coding-harness/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 skills/vibe-coding-harness từ repo GitHub Junliu1066/vibe-coding-kit vào ~/.claude/skills/vibe-coding-harness/ 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/Junliu1066/vibe-coding-kit.git && mkdir -p ~/.claude/skills && cp -r vibe-coding-kit/skills/vibe-coding-harness ~/.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.
- Tải repo:
git clone https://github.com/Junliu1066/vibe-coding-kit.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r vibe-coding-kit/skills/vibe-coding-harness ~/.claude/skills/ - Skill phụ thuộc vào file quy tắc: hãy copy
harness.json(vàCLAUDE.mdnếu có) từ repo vào thư mục gốc dự án của bạn. - Khởi động lại Claude Code, rồi nói "kiểm định đầu ra" hoặc "kiểm tra các file trong docs/ có đúng chuẩn không".
- Lưu ý: nếu thiếu
harness.jsonhoặc chưa có tài liệu nào, hầu hết mục kiểm tra sẽ báo "chưa kích hoạt".
Xem mã nguồn trên GitHub ↗Giấy phép: MIT