# Đóng Góp Cho Claude How To / Contributing to Claude How To 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 ```bash git clone https://github.com/luongnv89/claude-howto.git cd claude-howto ``` ### 2. Tạo một Nhánh Sử dụng tên nhánh mô tả: ```bash 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:** ```bash # 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:** ```bash 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