CHỦ ĐỀ 07 · Năng suất & vận hành
Claude Code trong quy trình của đội
Biến hướng dẫn của dự án thành ngữ cảnh hữu ích và quy trình có thể kiểm tra.
01Hướng dẫn phải đúng phạm vi
CLAUDE.md nên mô tả lệnh build, cách kiểm thử và quy ước dự án. Quy tắc chỉ áp dụng cho một phần codebase nên được đặt gần phạm vi đó hoặc trong các rules phù hợp. Tránh một file hướng dẫn khổng lồ chứa thông tin đã lỗi thời.
02Cấu hình nhóm và dữ liệu cá nhân
Đưa quy ước dùng chung vào version control để review. Giữ bí mật và tuỳ chỉnh cá nhân ngoài repository. Kiểm tra quyền công cụ và cấu hình trước khi áp dụng cho cả đội. Hướng dẫn bằng văn bản không thay thế phân quyền ở hệ điều hành hoặc dịch vụ.
03Thay đổi vẫn cần bằng chứng
Dùng Claude hỗ trợ phân tích, sửa code và đề xuất test nhưng giữ kiểm tra chất lượng trong CI. Người review cần hiểu hành vi thay đổi, bằng chứng kiểm thử và rủi ro còn lại. Tốc độ sinh code không đồng nghĩa tốc độ giao phần mềm đáng tin cậy.
GÓC QUYẾT ĐỊNH
Mỗi người hướng dẫn Claude chạy một bộ lệnh kiểm thử khác nhau, dẫn tới PR có độ tin cậy không đồng đều.
Chuẩn hoá lệnh trong hướng dẫn dùng chung, cập nhật CI tương ứng và để cấu hình được review cùng code. Không dựa vào ghi nhớ cá nhân.
Những điều cần giữ lại
- Hướng dẫn ngắn, đúng phạm vi và được cập nhật.
- Cấu hình dùng chung cần version control.
- Review và CI vẫn là một phần của quy trình.
Thuật ngữ quan trọng
7 thuật ngữ của bài — lưu thành thẻ ghi nhớ để ôn theo lịch.
- CLAUDE.md
- File hướng dẫn dự án cho Claude Code: lệnh build, cách kiểm thử, quy ước. Nên ngắn, đúng phạm vi và được cập nhật, tránh một file khổng lồ chứa thông tin lỗi thời.
- Scoped instructions
- Hướng dẫn chỉ áp dụng cho một phần codebase, đặt gần phần đó hoặc trong rules phù hợp thay vì dồn vào một file chung.
- Shared configuration
- Cấu hình và quy ước dùng chung của đội, đưa vào version control để được review cùng code. Bí mật và tuỳ chỉnh cá nhân thì để ngoài repository.
- Tool permissions
- Quyền dùng công cụ được cấu hình cho Claude Code. Phải kiểm trước khi áp cho cả đội, và hướng dẫn bằng văn bản không thay được phân quyền ở hệ điều hành hay dịch vụ.
- CI (Continuous Integration)
- Hệ thống tự chạy kiểm tra chất lượng cho mỗi thay đổi. Code do Claude hỗ trợ viết vẫn phải qua CI, và lệnh kiểm thử trong hướng dẫn dùng chung nên khớp với CI.
- Code review
- Bước người review hiểu hành vi thay đổi, bằng chứng kiểm thử và rủi ro còn lại trước khi nhận code. Tốc độ sinh code không đồng nghĩa tốc độ giao phần mềm đáng tin cậy.
- Secret
- Thông tin bí mật như API key, token hay mật khẩu. Không đưa vào repository hay file hướng dẫn dùng chung; giữ ở kho bí mật hoặc cấu hình cá nhân nằm ngoài version control.
THỬ ÁP DỤNG
Viết một CLAUDE.md tối đa 15 dòng cho dự án mẫu: build, test, kiến trúc và quy tắc review.