Cảm ơn bạn quan tâm đến việc đóng góp cho dự án này! Hướng dẫn này sẽ giúp bạn hiểu cách đóng góp hiệu quả.

Về Dự Án Này / About This Project

Claude How To là một hướng dẫn trực quan, dựa trên ví dụ cho Claude Code. Chúng tôi cung cấp:

• Sơ đồ Mermaid giải thích cách các tính năng hoạt động
• Mẫu sản xuất sẵn bạn có thể sử dụng ngay lập tức
• Ví dụ thực tế với ngữ cảnh và thực hành tốt nhất
• Đường dẫn học tập tiến bộ từ người mới bắt đầu đến nâng cao

Các Loại Đóng Góp / Types of Contributions

1. Ví Dụ hoặc Mẫu Mới

Thêm ví dụ cho các tính năng hiện có (slash commands, skills, hooks, v.v.):

• Code sẵn sàng để copy-paste
• Giải thích rõ ràng cách nó hoạt động
• Các trường hợp sử dụng và lợi ích
• Mẹo xử lý sự cố

2. Cải Tiện Tài Liệu

• Làm rõ các phần nhầm hiểu
• Sửa lỗi chính tả và ngữ pháp
• Thêm thông tin còn thiếu
• Cải thiện các ví dụ code

3. Hướng Dẫn Tính Năng

Tạo hướng dẫn cho các tính năng Claude Code mới:

• Hướng dẫn từng bước
• Sơ đồ kiến trúc
• Các mẫu và anti-patterns phổ biến
• Workflows thực tế

4. Báo Cáo Lỗi

Báo cáo các vấn đề bạn gặp phải:

• Mô tả những gì bạn mong đợi
• Mô tả những gì thực sự xảy ra
• Bao gồm các bước để tái tạo
• Thêm phiên bản Claude Code và OS có liên quan

5. Feedback và Đề Xuất

Giúp cải thiện hướng dẫn:

• Đề xuất giải thích tốt hơn
• Chỉ ra các khoảng trống trong phạm vi
• Khuyến nghị các phần mới hoặc tái tổ chức

Bắt Đầu / Getting Started

1. Fork và Clone

git clone YOUR_REPO
cd claude-howto

2. Tạo một Nhánh

Sử dụng tên nhánh mô tả:

git checkout -b add/feature-name
git checkout -b fix/issue-description
git checkout -b docs/improvement-area

3. Thiết Lập Môi Trường Của Bạn

Pre-commit hooks chạy cùng các kiểm tra như CI cục bộ trước mỗi commit. Tất cả bốn kiểm tra phải pass trước khi PR được chấp nhận.

Dependencies được yêu cầu:

# Python tooling (uv là trình quản lý package cho dự án này)
pip install uv
uv venv
source .venv/bin/activate
uv pip install -r scripts/requirements-dev.txt

# Markdown linter (Node.js)
npm install -g markdownlint-cli

# Mermaid diagram validator (Node.js)
npm install -g @mermaid-js/mermaid-cli

# Install pre-commit và activate hooks
uv pip install pre-commit
pre-commit install

Xác minh thiết lập của bạn:

pre-commit run --all-files

Các hooks chạy trên mỗi commit là:

• Kiểm tra markdown-lint
• Kiểm tra cross-references
• Kiểm tra mermaid-syntax
• Kiểm tra link-check

Thank you for contributing! 🙏

Cập Nhật Lần Cuối: Tháng 4 năm 2026