gap-trap — Framework cổng chất lượng cho code do agent viết
Thiết lập và tinh chỉnh một framework chất lượng, trong đó mọi quy tắc đều có "cổng" làm fail commit, push hoặc CI khi bị vi phạm.
Lập trìnhNâng cao★ 181⑂ 9Điểm AI 9/10Cập nhật lần cuối: 2 thg 10, 2026
Làm được gì
- Khảo sát repo: stack, lệnh test/lint, nhà cung cấp CI, các ứng viên "contract" với tên symbol thật, rồi xác nhận một lần trước khi thực thi.
- Sinh các file hướng dẫn (
AGENTS.md,AGENTS.project.md,CLAUDE.md,agents/) từ template và di trú quy tắc cũ từ.cursorrules,copilot-instructions.md,CONTRIBUTING.mdtheo bảng đối chiếu, không bỏ âm thầm quy tắc nào. - Viết cổng thật: kiểm tra file hướng dẫn, proven-red test, kiểm tra nội dung PR, ratchet (đếm vi phạm và chỉ cho phép giảm), mutation smoke cho module rủi ro; mỗi cổng đều được chứng minh fail trước rồi commit từng thay đổi logic riêng.
- Chế độ
refine: audit quy tắc không có cổng, contract trỏ tới symbol đã mất, và lịch sử commit để đề xuất bước tiếp theo dưới dạng một PR.
Dành cho ai
- Nhóm/dev để agent (Claude Code, Codex) viết phần lớn code
- Người muốn quy tắc dự án được thực thi tự động thay vì chỉ nằm trong tài liệu
- Người có quyền sửa pre-commit hook và CI, và dùng được model mạnh nhất (Opus)
Ví dụ sử dụng
gap-trap setup— dựng contract, cổng, hook, CI cho repo chưa có gì.gap-trap refine— sau sự cố đầu tiên, rút ra quy tắc và cổng tiếp theo từ những gì đã vỡ.- "gate the rules" — chuyển các quy tắc văn xuôi trong
AGENTS.mdthành quy tắc có ID kèm tên cổ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 AI 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 && cp -r /tmp/gap-trap/gap-trap ~/.claude/skills/ && rm -rf /tmp/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 vào thư mục tạm:
git clone https://github.com/pliablepixels/gap-trap.git /tmp/gap-trap - Tạo thư mục skills nếu chưa có:
mkdir -p ~/.claude/skills - Copy skill:
cp -r /tmp/gap-trap/gap-trap ~/.claude/skills/ - Dọn thư mục tạm:
rm -rf /tmp/gap-trap - Khởi động lại Claude Code (danh sách skill chỉ đọc khi bắt đầu session).
- Dùng
/modelchọn model cấp cao nhất (Opus); với model rẻ hơn, skill sẽ tự dừng. - Trong repo mục tiêu, yêu cầu
gap-trap setuphoặcgap-trap refine. Nên tạo branch riêng vì skill sẽ commit và sửa file CI.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT