Lệnh /push là rào chắn an toàn (Guards) đảm bảo không ai hoặc AI agent nào có thể vô tình đẩy lỗi hay thông tin nhạy cảm vào kho lưu trữ (Repository).
Nó thực hiện quét khóa nhạy cảm, chạy build check, sinh nội dung theo chuẩn Conventional Commits và tự động sinh bản Changelog trước khi Git commit/push.
Cú Pháp Khai Báo
/push [project-name] # Mặc định: Chạy Build & Test trước
/push [project-name] --quick # Bỏ qua dòng build
/push [project-name] "feat: new thing" # Lời bình commit chủ độngCác Rào Chắn An Toàn (Safety Guards)
0. Rules Pre-flight (v1.5.4)
Trước khi bất kỳ bước nào chạy, agent đọc lại .agent/rules.md từ đĩa để phục hồi ngữ cảnh rules. Đây là phần của cơ chế Defense-in-Depth Lớp 3 — đảm bảo rules tồn tại sau khi context bị cắt trong phiên dài.
1. Quét File Bảo Mật (BẮT BUỘC)
Quét toàn bộ Git Tree tìm dấu lọt bí mật. Hành động sẽ CHẶN ĐỨNG mã và cảnh báo cực tím nếu tìm thấy các tệp tin env, pem, key hoặc .idea chưa nằm trong file bỏ qua chuẩn của gitignore.
2. Auto-Testing Pipeline
Mặc định sẽ kích hoạt kịch bản build Production (npm run build). Nếu có lỗi nổ ra, nó ép buộc Agent hoặc User sửa lại đoạn mã lỗi thay vì force commit, đảm bảo kho chứa chỉ chứa mã nguồn Vàng.
3. Conventional Commit Generator
Tự suy diễn thay đổi thành các dòng Log cấu trúc có hậu tố như feat:, fix:, docs:, refactor:. Sau đó tự động ghi cập nhật lịch sử này vào tệp tin CHANGELOG.md cho mục ghi danh tính năng sắp release (Unreleased).