mirror of
https://github.com/luongnv89/claude-howto.git
synced 2026-08-08 00:08:36 +02:00
Luong NGUYENandGitHub
b9a973bf32
Internal accuracy pass against v2.1.220 — no missing upstream features, but broken example code, disagreeing counts, and metadata drift.
Functional fixes: pre-commit.sh now exits 2 so it actually blocks; dependency-check.sh reads file_path from stdin JSON instead of $1; database-mcp.json uses ${DATABASE_URL}; broken fences repaired; three command templates had invalid skill names.
Factual corrections: /fork and /subtask unswapped and /subtask added; /fewer-permission-prompts; permissions.defaultMode; dontAsk/auto unreversed; 31 hook events verified name-by-name; subagent depth 3; skill precedence enterprise > project > personal; /output-style removed not deprecated; permissionDecision gained defer.
Follow-up review fixed defects the pass left behind: zh/vi headers claiming 31 events above 25-name lists, a surviving hardcoded DB credential in the MCP README examples, an unbalanced fence swallowing a metadata footer, and non-canonical tool names. All four translated CATALOG summary tables were recounted so their arithmetic holds.
Full detail in CHANGELOG.md under v2.1.220-r2.
111 lines
3.3 KiB
Markdown
111 lines
3.3 KiB
Markdown
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="../resources/logos/claude-howto-logo-dark.svg">
|
|
<img alt="Claude How To" src="../resources/logos/claude-howto-logo.svg">
|
|
</picture>
|
|
|
|
# Đó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ả năm 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
|