Lệnh thường dùng¶

Bảng tra nhanh các câu lệnh terminal bạn dùng trong quá trình làm dự án. Copy là chạy.

Claude không tự commit/push — phải có bạn xác nhận

Khi bạn gọi skill lam-task / phan-cong, Claude tạo nhánh và soạn nội dung, nhưng chỉ commit & push sau khi bạn xác nhận "task đã hoàn thành". Bạn không bắt buộc gõ tay các lệnh git — nhưng nên hiểu để kiểm tra & gỡ rối. Riêng lệnh xem kết quả (mkdocs serve, http.server) thì bạn tự chạy.

Cài đặt một lần (máy mới)¶

# 1) Khai báo bạn là ai — Claude dựa vào đây để biết task nào của bạn
git config user.name  "Họ Tên Của Bạn"
git config user.email "email-dung-trong-roster"   # đúng email ở cong-viec/thanh-vien.md

# 2) Cài công cụ render tài liệu (cần Python sẵn trên máy)
pip install -r requirements.txt

Kiểm tra định danh đã đúng chưa:

git config user.name
git config user.email

Mỗi buổi làm — đồng bộ trước¶

git checkout main && git pull   # lấy bản mới nhất (gồm task mới giao)
git status                      # xem đang ở nhánh nào, có gì thay đổi chưa lưu
git branch                      # liệt kê các nhánh, dấu * là nhánh hiện tại

Làm một task¶

Trình tự một task (skill lam-task lo các bước này — nhưng hai bước commit và push cuối chỉ chạy sau khi bạn xác nhận task đã xong):

git checkout -b ba/<id>/<task-id>      # tạo nhánh riêng cho task, vd: ba/mai/TASK-01
# ... làm việc qua chat với Claude ...
git add <file-trong-pham-vi>           # chỉ thêm file thuộc phạm vi task
git commit -m "feat: mô tả ngắn"       # commit nhỏ, rõ (xem rules/git-commit.md)
git pull --rebase origin main          # cập nhật việc mới trước khi đẩy, giảm xung đột
git push -u origin ba/<id>/<task-id>   # đẩy nhánh lên GitLab

Sau đó lên GitLab mở Merge Request vào main, gán Quản lý duyệt. BA không tự merge.

Xem kết quả trước khi đẩy¶

mkdocs serve            # xem trang tài liệu → http://localhost:8000 (Ctrl+C để dừng)
mkdocs build --strict   # kiểm tra lỗi nav/link gãy mà không cần mở web

Xem mockup & chia sẻ nội mạng cho cả đội:

cd ui-mockups
python -m http.server 8080   # mở http://<ip-may-ban>:8080 từ máy khác trong công ty

Kiểm tra & gỡ rối¶

git status                 # luôn chạy đầu tiên khi không chắc đang ở đâu
git diff                   # xem chính xác mình đã đổi gì (chưa commit)
git log --oneline -10      # 10 commit gần nhất
git switch main            # quay về nhánh main
git switch <ten-nhanh>     # chuyển sang nhánh khác (vd ba/mai/TASK-01)

Lệnh xóa thay đổi — cẩn thận

git checkout -- <file> và git reset --hard sẽ xóa vĩnh viễn thay đổi chưa commit. Không chắc thì đừng chạy — hỏi Quản lý hoặc nhờ Claude xem git status / git diff trước. Đặc biệt không git push --force lên main.

Bảng tra nhanh¶

Tình huống	Lệnh
Tôi là ai (git)	`git config user.email`
Lấy bản mới nhất	`git checkout main && git pull`
Đang ở nhánh nào, đổi gì	`git status`
Tạo nhánh task	`git checkout -b ba/<id>/<task-id>`
Cập nhật trước khi đẩy	`git pull --rebase origin main`
Đẩy nhánh lên	`git push -u origin ba/<id>/<task-id>`
Xem trang tài liệu	`mkdocs serve` → http://localhost:8000
Kiểm tra link gãy	`mkdocs build --strict`
Xem mockup nội mạng	`cd ui-mockups && python -m http.server 8080`

Quy trình tổng thể: Bắt đầu cho BA · quy ước commit: rules/git-commit.md.