gap-trap — Khung chất lượng có cổng kiểm tra cho code do agent viết
Kỹ năng cài đặt và tinh chỉnh một khung chất lượng, trong đó mọi quy tắc đều phải có cổng kiểm tra làm fail commit, push hoặc CI.
Lập trìnhNâng cao★ 144⑂ 6Điểm AI 9/10Cập nhật lần cuối: 15 thg 9, 2026
Làm được gì
- Khảo sát repo (stack, lệnh test/lint, nhà cung cấp CI, ứng viên hợp đồng kiến trúc, lịch sử commit) rồi xin xác nhận kế hoạch một lần duy nhất.
- Sinh các file hướng dẫn
AGENTS.md,AGENTS.project.md,CLAUDE.md,agents/từ template và di trú quy tắc từ.cursorrules,copilot-instructions.md,CONTRIBUTING.mdtheo bảng đối chiếu. - Viết các cổng kiểm tra: cổng kiểm tra file hướng dẫn, proven-red test, kiểm tra nội dung PR, ratchet (bộ đếm vi phạm), mutation smoke cho module rủi ro (auth, parser, API client).
- Chứng minh từng cổng thực sự "đỏ" bằng một vi phạm nháp, sau đó xoá vi phạm và commit từng thay đổi logic.
- Chế độ
refinerà soát quy tắc không có cổng, hợp đồng trỏ tới symbol đã biến mất, và đề xuất thay đổi dưới dạng một PR.
Phù hợp với ai
- Nhóm/cá nhân có repo mà agent AI viết phần lớn code.
- Người thấy quy tắc trong AGENTS.md/CLAUDE.md chỉ nằm trên giấy, không ai thực thi.
- Người muốn dùng CI để cưỡng chế chất lượng và theo dõi vi phạm bằng số liệu.
Ví dụ sử dụng
gap-trap setup— cài khung cho repo chưa có: tối đa sáu hợp đồng, bộ cổng kiểm tra, báo cáo số từ hướng dẫn và các mụcGate: review.gap-trap refine— chạy sau sự cố đầu tiên để bỏ quy tắc vô ích và thêm cổng cho chỗ vừa vỡ.- Nói "gate the rules" hoặc "làm cho code của agent khớp với quy tắc" cũng kích hoạt kỹ năng.
· · · 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/pliablepixels/gap-trap/HEAD/gap-trap/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 gap-trap từ repo GitHub pliablepixels/gap-trap vào ~/.claude/skills/gap-trap/ 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/pliablepixels/gap-trap.git /tmp/gap-trap && mkdir -p ~/.claude/skills && cp -r /tmp/gap-trap/gap-trap ~/.claude/skills/gap-trap⚠ Đâ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:
git clone https://github.com/pliablepixels/gap-trap.git /tmp/gap-trap - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Copy kỹ năng:
cp -r /tmp/gap-trap/gap-trap ~/.claude/skills/gap-trap - Mở Claude Code và chuyển sang model Opus bằng
/model— kỹ năng sẽ từ chối chạy trên Sonnet/Haiku. - Trong thư mục repo mục tiêu, yêu cầu:
gap-trap setup. - Xem kỹ bảng kế hoạch và diff các file hướng dẫn trước khi đồng ý (kỹ năng sẽ cài thêm skill
slop-mop).
Xem mã nguồn trên GitHub ↗Giấy phép: MIT