Contextual Commit

Kỹ năng này làm gì

• Giữ nguyên dòng tiêu đề theo chuẩn Conventional Commits (feat(scope): ...).
• Thêm vào body các dòng có cấu trúc action-type(scope): mô tả để lưu lại lý do mà diff không thể hiện được.
• Các loại dòng: intent (người dùng muốn gì), decision (phương án đã chọn), rejected (phương án bị loại + lý do), constraint (giới hạn phát hiện khi làm), learned (điều nên biết sớm hơn).
• Trước khi viết, chạy git diff --cached --stat để xác định phạm vi commit; nếu không có gì được stage thì xét các file đã sửa/chưa theo dõi.
• Có quy tắc chống bịa: những gì không suy ra được từ diff (intent, rejected, constraint, learned) thì tuyệt đối không tự nghĩ ra.

Phù hợp với ai

• Lập trình viên thường xuyên tự hỏi "vài tháng trước mình chọn cách này vì sao?"
• Người làm việc cùng AI agent và muốn giữ lại ngữ cảnh sau khi phiên chat kết thúc.
• Team lead muốn lịch sử git trở thành tài liệu onboarding.
• Nhóm đã dùng Conventional Commits và cần một phần mở rộng không phá vỡ tooling hiện có.

Ví dụ sử dụng

1. Sau khi chuyển hệ thống thanh toán sang đa tiền tệ: body ghi rejected(money-library): accounting.js — không hỗ trợ tính toán đơn vị nhỏ (cents), giúp phiên sau không đề xuất lại.
2. Sau khi thêm đăng nhập Google OAuth: intent(auth): social login, bắt đầu với Google, learned(passport-google): cần scope offline_access để có refresh token.
3. Khi commit gồm cả thay đổi của người khác: chỉ ghi decision(http-client): đổi từ axios sang native fetch vì đó là điều thấy rõ trong diff, không đoán intent.

Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình:
https://raw.githubusercontent.com/berserkdisruptors/contextual-commits/HEAD/skills/contextual-commit/SKILL.md

Mình muốn: (viết việc bạn cần ở đây)

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục skills/contextual-commit từ repo GitHub berserkdisruptors/contextual-commits vào ~/.claude/skills/contextual-commit/ 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.