Files
Thiên Toán a70777e9bc Add Vietnamese (Tiếng Việt) Localization (#42)
* feat(i18n): add Vietnamese localization infrastructure

Add comprehensive infrastructure for Vietnamese translation of the
claude-howto documentation:

Features:
- Parallel vi/ directory structure for Vietnamese content
- Modified build_epub.py with --lang flag for Vietnamese EPUB
- Vietnamese-specific pre-commit hooks for quality checks
- Translation support files (glossary, style guide, queue tracker)
- sync_translations.py script to detect outdated translations

Infrastructure:
- vi/ directory with all 10 module subdirectories
- TRANSLATION_NOTES.md: comprehensive glossary and style guide
- TRANSLATION_QUEUE.md: progress tracking for 66+ files
- vi/README.md: Vietnamese landing page

EPUB Build:
- Added --lang CLI flag (en/vi) to build_epub.py
- Language-specific metadata (title, subtitle)
- Automatic root path adjustment for vi/ directory
- Dynamic output filename (claude-howto-guide-vi.epub)

Quality Assurance:
- Vietnamese markdown linting
- Vietnamese cross-reference checking
- Vietnamese Mermaid syntax validation
- Vietnamese link checking
- Vietnamese EPUB build validation

Ready for translation work to begin.

* feat(vi): translate INDEX.md to Vietnamese

Complete Vietnamese translation of INDEX.md - the comprehensive
index of all example files in the repository.

Translation follows vi/TRANSLATION_NOTES.md guidelines:
- Technical terms kept per glossary (slash command → "lệnh slash")
- File paths and code blocks preserved in English
- Table structure and formatting maintained
- All 882 lines translated

Content includes:
- Complete file tree (10 modules, 100+ files)
- Feature coverage matrix
- Quick start guides by use case
- Learning path progression
- Search by keyword sections

Progress: 1/5 core documents completed

* feat(vi): translate CATALOG.md to Vietnamese

Complete Vietnamese translation of CATALOG.md - the quick reference
guide to all Claude Code features.

Translation follows vi/TRANSLATION_NOTES.md guidelines:
- Technical terms kept per glossary (slash command → "lệnh slash")
- All command names preserved (/help, /optimize, etc.)
- Code blocks, JSON examples, and bash commands unchanged
- All tables and formatting maintained
- 517 lines translated with complete feature coverage

Content includes:
- Summary statistics (99 built-in + 43 examples = 117 total)
- Complete built-in commands reference (55+ commands)
- Custom commands examples (8 commands)
- Permission modes (6 modes)
- Subagents (6 built-in + 10 custom)
- Skills (5 bundled + 4 custom)
- Plugins (3 complete plugins)
- MCP servers (1 built-in + 8 common servers)
- Hooks (25 events + 7 example hooks)
- Memory files (7 types)
- New features (March 2026) - 17 new features
- Installation priority guide
- Complete one-command installation

Progress: 2/5 core documents completed

* docs(vi): translate learning roadmap to Vietnamese

- Add complete Vietnamese translation of LEARNING-ROADMAP.md (747 lines)
- Include self-assessment quiz for level determination
- Translate three learning levels: Beginner, Intermediate, Advanced
- Translate all milestones (1A, 1B, 2A, 2B, 3A, 3B) with hands-on exercises
- Preserve Mermaid diagram for learning path visualization
- Maintain progress tracking checklists and learning tips

* docs(vi): translate quick reference guide to Vietnamese

- Add complete Vietnamese translation of QUICK_REFERENCE.md (507 lines)
- Include installation quick commands for all features
- Translate feature cheat sheet with usage examples
- Translate common use cases (code review, documentation, DevOps, etc.)
- Preserve all code snippets, commands, and file paths in English
- Maintain file locations reference diagram
- Include learning path and new features (March 2026) sections
- Keep tips & tricks, feature matrix, and checklist intact

* docs(vi): translate module 01 - slash commands to Vietnamese

- Add complete Vietnamese translation of 01-slash-commands/README.md (553 lines)
- Translate slash commands overview and architecture
- Include 55+ built-in commands reference table with Vietnamese descriptions
- Translate bundled skills section (5 skills)
- Document custom commands (now skills) migration path
- Include frontmatter reference, arguments, and dynamic context sections
- Preserve all command names, code examples, and Mermaid diagrams
- Translate 8 available commands in folder with usage examples
- Include installation, troubleshooting, and best practices sections

* docs(vi): update translation queue progress - Module 01 README done

- Mark 01-slash-commands/README.md as completed (2026-04-02)
- Update Module 01 progress: 1/9 files (11%)
- Update overall progress: 6/66 files (9%)
- Update Priority 2 progress: 1/31 files (3%)
- Add recent completion note to queue header

* docs(vi): translate slash command - commit to Vietnamese

- Translate commit.md slash command to Vietnamese
- Keep all git commands and technical syntax intact
- Translate instructions and descriptions
- Maintain conventional commits format documentation

* docs(vi): translate slash command - doc-refactor to Vietnamese

- Translate doc-refactor.md slash command to Vietnamese
- Keep all technical terms and file paths intact
- Translate documentation refactoring instructions
- Maintain structure and numbering

* docs(vi): translate slash command - generate-api-docs to Vietnamese

- Translate generate-api-docs.md slash command to Vietnamese
- Keep all technical terms and file paths intact
- Translate API documentation generation instructions
- Maintain output format specifications

* docs(vi): translate slash command - optimize to Vietnamese

- Translate optimize.md slash command to Vietnamese
- Keep all technical terms and code concepts intact
- Translate code optimization instructions
- Maintain issue priority and response format

* docs(vi): translate slash command - pr to Vietnamese

- Translate pr.md slash command to Vietnamese
- Keep all commands and technical syntax intact
- Translate PR preparation checklist instructions
- Maintain conventional commits format documentation

* docs(vi): translate slash command - push-all to Vietnamese

- Translate push-all.md slash command to Vietnamese (153 lines)
- Keep all git commands and technical syntax intact
- Translate comprehensive workflow with safety checks
- Maintain API key validation patterns and error handling
- Preserve when to use/avoid sections and alternatives

* docs(vi): translate slash command - setup-ci-cd to Vietnamese

- Translate setup-ci-cd.md slash command to Vietnamese
- Keep all tool names and technical terms intact
- Translate CI/CD pipeline implementation instructions
- Maintain pre-commit hooks and GitHub Actions sections

* docs(vi): translate slash command - unit-test-expand to Vietnamese

- Translate unit-test-expand.md slash command to Vietnamese
- Keep all framework names and technical terms intact
- Translate test coverage expansion instructions
- Maintain testing frameworks and scenario sections

* docs(vi): update translation queue - Module 01 complete (100%)

- Mark all 9 Module 01 files as completed (2026-04-02)
- Update Module 01 progress: 9/9 files (100%) 
- Update overall progress: 14/66 files (21%)
- Update Priority 2 progress: 9/31 files (29%)
- Update header with Module 01 completion milestone

Module 01: Slash Commands - All files translated:
 README.md (overview, built-in commands, skills)
 commit.md (git commit with context)
 doc-refactor.md (documentation restructuring)
 generate-api-docs.md (API documentation generator)
 optimize.md (code optimization analysis)
 pr.md (pull request preparation)
 push-all.md (stage, commit, push with safety)
 setup-ci-cd.md (CI/CD pipeline implementation)
 unit-test-expand.md (test coverage expansion)

* docs(vi): translate module 02 - memory guide to Vietnamese

- Add complete Vietnamese translation of 02-memory/README.md (1162 lines)
- Translate memory system overview and architecture
- Include quick reference for memory commands (/init, /memory, #)
- Document complete memory hierarchy (8 levels with precedence)
- Translate auto memory section with architecture diagrams
- Include practical examples (project, directory-specific, personal memory)
- Add best practices, installation instructions, and troubleshooting
- Preserve all code examples, file paths, and technical terms
- Maintain Mermaid diagrams and tables

* docs(vi): translate example project CLAUDE.md to Vietnamese

- Translate project-CLAUDE.md example memory file
- Keep all technical terms, commands, and code style intact
- Translate descriptions and explanations
- Maintain project configuration structure

* docs(vi): translate example personal CLAUDE.md to Vietnamese

- Translate personal-CLAUDE.md example memory file
- Keep all technical terms, tools, and preferences intact
- Translate descriptions and explanations
- Maintain personal preferences structure

* docs(vi): translate example directory-specific CLAUDE.md to Vietnamese

- Translate directory-api-CLAUDE.md example memory file
- Keep all technical terms, API standards, and code examples intact
- Translate descriptions and explanations
- Maintain API module standards structure

* docs(vi): update translation queue - Module 02 complete (100%)

- Mark all 4 Module 02 files as completed (2026-04-02)
- Update Module 02 progress: 4/4 files (100%) 
- Update overall progress: 18/66 files (27%)
- Update Priority 2 progress: 13/31 files (42%)
- Update header with Module 02 completion milestone

Module 02: Memory - All files translated:
 README.md (1162 lines - comprehensive memory guide)
 project-CLAUDE.md (example project memory)
 personal-CLAUDE.md (example personal preferences)
 directory-api-CLAUDE.md (example directory-specific rules)

* docs(vi): translate module 03 - skills guide to Vietnamese

- Add complete Vietnamese translation of 03-skills/README.md (805 lines)
- Translate Agent Skills overview and architecture
- Include progressive disclosure loading mechanism (3 levels)
- Document skill types, locations, and automatic discovery
- Translate skill creation process and SKILL.md format
- Include required and optional frontmatter fields
- Document skill content types (reference vs task)
- Translate controlling skill invocation and string substitutions
- Include dynamic context injection with shell commands
- Document running skills in subagents with context: fork
- Translate 6 practical examples with directory structures
- Add supporting files, management, and best practices sections
- Preserve all code examples, YAML frontmatter, and Mermaid diagrams
- Maintain tables, troubleshooting guides, and security considerations

* docs(vi): translate skill - blog-draft to Vietnamese

- Translate blog-draft/SKILL.md to Vietnamese (275 lines)
- Keep all workflow steps and technical structure intact
- Translate instructions and descriptions
- Maintain version tracking and file structure
- Preserve all markdown formatting and code examples

* docs(vi): translate skill - brand-voice to Vietnamese

- Translate brand-voice/SKILL.md to Vietnamese (73 lines)
- Keep brand identity, tone, and vocabulary intact
- Translate writing guidelines and examples
- Maintain preferred/avoided terms sections
- Preserve good/bad examples with explanations

* docs(vi): translate skill - claude-md to Vietnamese

- Translate claude-md/SKILL.md to Vietnamese (213 lines)
- Keep all golden rules and core principles intact
- Translate execution flow and content strategy
- Maintain WHAT/WHY/HOW structure
- Preserve quality constraints and validation checklist
- Keep anti-patterns and output format sections

* docs(vi): translate skill - code-review to Vietnamese

- Translate code-review/SKILL.md to Vietnamese (71 lines)
- Keep all review categories and template intact
- Translate security, performance, quality, maintainability sections
- Maintain review template structure
- Preserve version history

* docs(vi): translate skill - refactor to Vietnamese

- Translate refactor/SKILL.md to Vietnamese (427 lines)
- Keep all Martin Fowler refactoring methodology intact
- Translate 6-phase workflow with detailed steps
- Maintain core principles and safety rules
- Preserve code smell catalog and refactoring techniques
- Keep quick start example with before/after code
- Maintain version history and references sections

* docs(vi): update translation queue - Module 03 complete (100%)

- Mark all 6 Module 03 files as completed (2026-04-02)
- Update Module 03 progress: 6/6 files (100%) 
- Update overall progress: 24/66 files (36%)
- Update Priority 2 progress: 19/31 files (61%)
- Update header with Module 03 completion milestone

Module 03: Skills - All files translated:
 README.md (805 lines - comprehensive skills guide)
 blog-draft/SKILL.md (275 lines - blog post creation workflow)
 brand-voice/SKILL.md (73 lines - brand voice consistency)
 claude-md/SKILL.md (213 lines - CLAUDE.md best practices)
 code-review/SKILL.md (71 lines - comprehensive code review)
 refactor/SKILL.md (427 lines - Fowler refactoring methodology)

* docs(vi): translate Module 04 Subagents README

Complete Vietnamese translation of subagents reference guide:
- Configuration and built-in subagents (general-purpose, Plan, Explore, Bash, statusline-setup, Claude Code Guide)
- Agent management with /agents command
- Automatic delegation vs explicit invocation
- Resumable agents and chaining
- Persistent memory across agent sessions
- Background subagents for parallel work
- Worktree isolation for safe experimentation
- Agent Teams (experimental feature)
- Best practices and usage patterns

* docs(vi): complete Module 04 Subagents translation

Translate all 6 subagent example definitions:
- code-reviewer.md: Expert code review specialist
- debugger.md: Root cause analysis and debugging
- documentation-writer.md: Technical documentation creation
- implementation-agent.md: Full-stack feature implementation
- secure-reviewer.md: Security-focused code review
- test-engineer.md: Comprehensive test coverage

Update translation queue progress:
- Module 04: 7/7 files (100%) 
- Overall: 31/66 files (47%)
- Next: Module 05 (MCP)

* docs(vi): complete Module 05 MCP translation

Translate comprehensive MCP (Model Context Protocol) guide:
- Overview and architecture diagrams
- Installation methods (HTTP, Stdio, SSE, WebSocket)
- OAuth 2.0 authentication support
- MCP tool search and dynamic updates
- Elicitation and prompt slash commands
- Configuration management (local, project, user scopes)
- Practical examples (GitHub, Database, Filesystem, Slack MCPs)
- MCP vs Memory decision matrix
- Code execution approach for solving context bloat
- MCPorter runtime reference
- Security best practices and troubleshooting

Translate 4 MCP configuration JSON examples:
- filesystem-mcp.json: File operations
- github-mcp.json: GitHub integration
- database-mcp.json: SQL queries
- multi-mcp.json: Multiple servers configuration

Update translation queue progress:
- Module 05: 5/5 files (100%) 
- Overall: 36/66 files (55%)
- Next: Module 06 (Hooks)

* docs(vi): complete Module 06 Hooks translation

Translate comprehensive Hooks guide:
- Overview and architecture
- Configuration structure (user, project, local scopes)
- Four hook types: command, HTTP, prompt, agent
- 25 hook events with matcher patterns
- Component-scoped hooks and subagent frontmatter
- JSON input/output format and exit codes
- Environment variables and best practices
- Security considerations and debugging
- Installation instructions

Copy 9 hook example files (code, no translation needed):
- format-code.sh: Auto-format code after write/edit
- log-bash.sh: Bash command logging
- notify-team.sh: Team notifications
- pre-commit.sh: Pre-commit validation
- security-scan.sh: Security scanning
- validate-prompt.sh: Prompt validation
- context-tracker.py: Token usage tracking
- context-tracker-tiktoken.py: Accurate token counting

Update translation queue progress:
- Module 06: 9/9 files (100%) 
- Overall: 45/67 files (67%)
- Next: Module 07 (Plugins)

* docs(vi): complete Module 07 Plugins translation

Translate comprehensive Plugins guide:
- Overview and architecture diagrams
- Plugin loading process and lifecycle
- Plugin types (Official, Community, Organization, Personal)
- Plugin definition structure and manifest
- Plugin structure example with all directories
- LSP server configuration and examples
- Plugin options (v2.1.83+) with userConfig
- Persistent plugin data via CLAUDE_PLUGIN_DATA
- Inline plugins via settings (v2.1.80+)
- Standalone vs Plugin approach comparison
- Practical examples (PR Review, DevOps, Documentation plugins)
- Plugin marketplace and distribution
- Marketplace configuration and definition schema
- Plugin source types and distribution methods
- Plugin CLI commands and installation methods
- Plugin features comparison table
- Testing, hot-reload, and managed settings
- Plugin security restrictions
- Publishing workflow and best practices
- Complete troubleshooting guide

Copy all plugin subdirectories (code, no translation needed):
- devops-automation/: Deployment workflows, incident management
- documentation/: API docs, README generation, templates
- pr-review/: Pull request review automation

Update translation queue progress:
- Module 07: 10+/10+ files (100%) 
- Overall: 55+/67 files (82%)
- Next: Module 08-10 (Checkpoints, Advanced Features, CLI)

* docs(vi): complete Modules 08-10 translation

Module 08: Checkpoints and Rewind (2 files)
- Overview and architecture
- Access methods (keyboard shortcut, slash command)
- Five rewind options (restore code+conversation, conversation, code, summarize, cancel)
- Automatic checkpoints and retention policies
- Use cases and practical examples
- Integration with git and best practices

Module 09: Advanced Features (3 files)
- Planning Mode: Two-phase implementation approach
- Extended Thinking: Deep reasoning for complex problems
- Auto Mode: Background safety classifier
- Background Tasks, Scheduled Tasks
- Permission Modes (default, acceptEdits, plan, auto, dontAsk, bypassPermissions)
- Print Mode, Session Management
- Voice Dictation, Channels, Remote Control
- Web Sessions, Desktop App, Task List
- Git Worktrees, Sandboxing, Managed Settings

Module 10: CLI Reference (1 file)
- CLI commands reference
- Core flags and options
- Interactive vs Print Mode
- Model selection and configuration
- System prompt customization
- Tool & permission management
- Output formats and scripting

Update translation queue progress:
- Modules 08-10: 6/6 files (100%) 
- All Modules 01-10: 61+/61+ files (100%) 
- Overall: 61+/67 files (91%)
- Remaining: Supporting docs (6 files)

* docs(vi): complete supporting documentation translation

Translate all 5 supporting documents:
- CONTRIBUTING.md: Contribution guidelines
- SECURITY.md: Security policy and vulnerability reporting
- CODE_OF_CONDUCT.md: Community standards and harassment policy
- STYLE_GUIDE.md: Documentation formatting conventions
- CHANGELOG.md: Version history (v2.2.0, v2.1.1, v2.1.0, v2.0.0)

Update translation queue to 100% completion:
- All Modules 01-10: 61+ files (100%) 
- Supporting Docs: 5/5 files (100%) 
- Overall: 67+/67 files (100%) 
- Status: HOÀN THÀNH 

* fix(vi): fix mermaid syntax and broken cross-references in Vietnamese translation

Fix invalid `#` comment in mermaid block (use `%%` instead) and update
cross-reference script to support Unicode/Vietnamese diacritics in anchor
generation. Fix broken anchor links across vi/ documentation files.

* fix(vi): remove inline mermaid comment causing parse error

Inline %% comments on node definition lines are not supported by the
mermaid parser. The surrounding HTML comment already explains this is
an incorrect example.
2026-04-06 21:34:18 +02:00

31 KiB

Claude How To

Các Ví Dụ Claude Code - Danh Mục Hoàn Chỉnh

Tài liệu này cung cấp danh mục hoàn chỉnh của tất cả các file ví dụ được tổ chức theo loại tính năng.

Thống Kê Tóm Tắt

  • Tổng Số File: 100+ files
  • Danh Mục: 10 danh mục tính năng
  • Plugins: 3 plugins hoàn chỉnh
  • Skills: 6 skills hoàn chỉnh
  • Hooks: 8 hooks ví dụ
  • Sẵn Sàng Sử Dụng: Tất cả ví dụ

01. Lệnh Slash (10 files)

Các lệnh tắt do người dùng gọi cho các workflow phổ biến.

File Mô Tả Use Case
optimize.md Trình phân tích tối ưu hóa code Tìm vấn đề hiệu năng
pr.md Chuẩn bị pull request Tự động hóa workflow PR
generate-api-docs.md Trình tạo tài liệu API Tạo tài liệu API
commit.md Trình hỗ trợ commit message Commit chuẩn hóa
setup-ci-cd.md Thiết lập pipeline CI/CD Tự động hóa DevOps
push-all.md Push tất cả thay đổi Workflow push nhanh
unit-test-expand.md Mở rộng độ phủ unit test Tự động hóa test
doc-refactor.md Tái cấu trúc tài liệu Cải thiện tài liệu
pr-slash-command.png Ví dụ screenshot Tham khảo hình ảnh
README.md Tài liệu Hướng dẫn cài đặt và sử dụng

Đường Dẫn Cài Đặt: .claude/commands/

Cách Dùng: /optimize, /pr, /generate-api-docs, /commit, /setup-ci-cd, /push-all, /unit-test-expand, /doc-refactor


02. Bộ Nhớ (6 files)

Ngữ cảnh lưu trữ và tiêu chuẩn dự án.

File Mô Tả Phạm Vi Vị Trí
project-CLAUDE.md Tiêu chuẩn dự án nhóm Toàn dự án ./CLAUDE.md
directory-api-CLAUDE.md Quy tắc cụ thể cho API Thư mục ./src/api/CLAUDE.md
personal-CLAUDE.md Sở thích cá nhân Người dùng ~/.claude/CLAUDE.md
memory-saved.png Screenshot: bộ nhớ đã lưu - Tham khảo hình ảnh
memory-ask-claude.png Screenshot: hỏi Claude - Tham khảo hình ảnh
README.md Tài liệu - Tham khảo

Cài Đặt: Sao chép đến vị trí phù hợp

Cách Dùng: Tự động tải bởi Claude


03. Skills (28 files)

Các khả năng tự động gọi với scripts và templates.

Code Review Skill (5 files)

code-review/
├── SKILL.md                          # Định nghĩa skill
├── scripts/
│   ├── analyze-metrics.py            # Trình phân tích metrics code
│   └── compare-complexity.py         # So sánh độ phức tạp
└── templates/
    ├── review-checklist.md           # Checklist review
    └── finding-template.md           # Tài liệu phát hiện

Mục Đích: Review code toàn diện với phân tích bảo mật, hiệu năng, và chất lượng

Tự Động Gọi: Khi review code


Brand Voice Skill (4 files)

brand-voice/
├── SKILL.md                          # Định nghĩa skill
├── templates/
│   ├── email-template.txt            # Định dạng email
│   └── social-post-template.txt      # Định dạng social media
└── tone-examples.md                  # Ví dụ tin nhắn

Mục Đích: Đảm bảo brand voice nhất quán trong communications

Tự Động Gọi: Khi tạo marketing copy


Documentation Generator Skill (2 files)

doc-generator/
├── SKILL.md                          # Định nghĩa skill
└── generate-docs.py                  # Trình trích xuất doc Python

Mục Đích: Tạo tài liệu API toàn diện từ source code

Tự Động Gọi: Khi tạo/cập nhật tài liệu API


Refactor Skill (5 files)

refactor/
├── SKILL.md                          # Định nghĩa skill
├── scripts/
│   ├── analyze-complexity.py         # Trình phân tích độ phức tạp
│   └── detect-smells.py              # Trình phát hiện code smells
├── references/
│   ├── code-smells.md                # Danh mục code smells
│   └── refactoring-catalog.md        # Patterns refactoring
└── templates/
    └── refactoring-plan.md           # Template kế hoạch refactoring

Mục Đích: Refactor code có hệ thống với phân tích độ phức tạp

Tự Động Gọi: Khi refactor code


Claude MD Skill (1 file)

claude-md/
└── SKILL.md                          # Định nghĩa skill

Mục Đích: Quản lý và tối ưu hóa files CLAUDE.md


Blog Draft Skill (3 files)

blog-draft/
├── SKILL.md                          # Định nghĩa skill
└── templates/
    ├── draft-template.md             # Template blog draft
    └── outline-template.md           # Template blog outline

Mục Đích: Soạn blog posts với cấu trúc nhất quán

Plus: README.md - Tổng quan skills và hướng dẫn sử dụng

Đường Dẫn Cài Đặt: ~/.claude/skills/ hoặc .claude/skills/


04. Tác Nhân Con (9 files)

Các trợ lý AI chuyên biệt với khả năng tùy chỉnh.

File Mô Tả Tools Use Case
code-reviewer.md Phân tích chất lượng code read, grep, diff, lint_runner Review toàn diện
test-engineer.md Phân tích độ phủ test read, write, bash, grep Tự động hóa test
documentation-writer.md Tạo tài liệu read, write, grep Tạo tài liệu
secure-reviewer.md Review bảo mật (read-only) read, grep Kiểm tra bảo mật
implementation-agent.md Triển khai hoàn chỉnh read, write, bash, grep, edit, glob Phát triển tính năng
debugger.md Chuyên gia debug read, bash, grep Điều tra bug
data-scientist.md Chuyên gia phân tích dữ liệu read, write, bash Workflow dữ liệu
clean-code-reviewer.md Tiêu chuẩn clean code read, grep Chất lượng code
README.md Tài liệu - Hướng dẫn cài đặt và sử dụng

Đường Dẫn Cài Đặt: .claude/agents/

Cách Dùng: Tự động ủy quyền bởi tác nhân chính


05. Giao Thức MCP (5 files)

Các tích hợp công cụ và API bên ngoài.

File Mô Tả Tích Hợp Với Use Case
github-mcp.json Tích hợp GitHub GitHub API Quản lý PR/issue
database-mcp.json Truy vấn database PostgreSQL/MySQL Truy vấn dữ liệu trực tiếp
filesystem-mcp.json Thao tác file Filesystem cục bộ Quản lý file
multi-mcp.json Nhiều servers GitHub + DB + Slack Tích hợp hoàn chỉnh
README.md Tài liệu - Hướng dẫn cài đặt và sử dụng

Đường Dẫn Cài Đặt: .mcp.json (phạm vi dự án) hoặc ~/.claude.json (phạm vi người dùng)

Cách Dùng: /mcp__github__list_prs, v.v.


06. Hooks (9 files)

Các script tự động hóa dựa trên sự kiện thực thi tự động.

File Mô Tả Sự Kiện Use Case
format-code.sh Tự động format code PreToolUse:Write Format code
pre-commit.sh Chạy test trước commit PreToolUse:Bash Tự động hóa test
security-scan.sh Quét bảo mật PostToolUse:Write Kiểm tra bảo mật
log-bash.sh Ghi log bash commands PostToolUse:Bash Ghi log commands
validate-prompt.sh Xác thực prompts PreToolUse Xác thực input
notify-team.sh Gửi thông báo Notification Thông báo nhóm
context-tracker.py Theo dõi usage context window PostToolUse Giám sát context
context-tracker-tiktoken.py Theo dõi context dựa trên token PostToolUse Đếm token chính xác
README.md Tài liệu - Hướng dẫn cài đặt và sử dụng

Đường Dẫn Cài Đặt: Cấu hình trong ~/.claude/settings.json

Cách Dùng: Cấu hình trong settings, thực thi tự động

Hook Types (4 types, 25 events):

  • Tool Hooks: PreToolUse, PostToolUse, PostToolUseFailure, PermissionRequest
  • Session Hooks: SessionStart, SessionEnd, Stop, StopFailure, SubagentStart, SubagentStop
  • Task Hooks: UserPromptSubmit, TaskCompleted, TaskCreated, TeammateIdle
  • Lifecycle Hooks: ConfigChange, CwdChanged, FileChanged, PreCompact, PostCompact, WorktreeCreate, WorktreeRemove, Notification, InstructionsLoaded, Elicitation, ElicitationResult

07. Plugins (3 plugins hoàn chỉnh, 40 files)

Các bộ sưu tập tính năng được đóng gói.

PR Review Plugin (10 files)

pr-review/
├── .claude-plugin/
│   └── plugin.json                   # Plugin manifest
├── commands/
│   ├── review-pr.md                  # Review toàn diện
│   ├── check-security.md             # Kiểm tra bảo mật
│   └── check-tests.md                # Kiểm tra độ phủ test
├── agents/
│   ├── security-reviewer.md          # Chuyên gia bảo mật
│   ├── test-checker.md               # Chuyên gia test
│   └── performance-analyzer.md       # Chuyên gia hiệu năng
├── mcp/
│   └── github-config.json            # Tích hợp GitHub
├── hooks/
│   └── pre-review.js                 # Xác thực pre-review
└── README.md                         # Tài liệu plugin

Tính Năng: Phân tích bảo mật, độ phủ test, tác động hiệu năng

Commands: /review-pr, /check-security, /check-tests

Cài Đặt: /plugin install pr-review


DevOps Automation Plugin (15 files)

devops-automation/
├── .claude-plugin/
│   └── plugin.json                   # Plugin manifest
├── commands/
│   ├── deploy.md                     # Triển khai
│   ├── rollback.md                   # Rollback
│   ├── status.md                     # Trạng thái hệ thống
│   └── incident.md                   # Phản hồi sự cố
├── agents/
│   ├── deployment-specialist.md      # Chuyên gia triển khai
│   ├── incident-commander.md         # Điều phối viên sự cố
│   └── alert-analyzer.md             # Trình phân tích alert
├── mcp/
│   └── kubernetes-config.json        # Tích hợp Kubernetes
├── hooks/
│   ├── pre-deploy.js                 # Kiểm tra pre-deployment
│   └── post-deploy.js                # Tasks post-deployment
├── scripts/
│   ├── deploy.sh                     # Tự động hóa triển khai
│   ├── rollback.sh                   # Tự động hóa rollback
│   └── health-check.sh               # Kiểm tra sức khỏe
└── README.md                         # Tài liệu plugin

Tính Năng: Triển khai Kubernetes, rollback, giám sát, phản hồi sự cố

Commands: /deploy, /rollback, /status, /incident

Cài Đặt: /plugin install devops-automation


Documentation Plugin (14 files)

documentation/
├── .claude-plugin/
│   └── plugin.json                   # Plugin manifest
├── commands/
│   ├── generate-api-docs.md          # Tạo tài liệu API
│   ├── generate-readme.md            # Tạo README
│   ├── sync-docs.md                  # Đồng bộ tài liệu
│   └── validate-docs.md              # Xác thực tài liệu
├── agents/
│   ├── api-documenter.md             # Chuyên gia tài liệu API
│   ├── code-commentator.md           # Chuyên gia comment code
│   └── example-generator.md          # Trình tạo ví dụ
├── mcp/
│   └── github-docs-config.json       # Tích hợp GitHub
├── templates/
│   ├── api-endpoint.md               # Template API endpoint
│   ├── function-docs.md              # Template tài liệu function
│   └── adr-template.md               # Template ADR
└── README.md                         # Tài liệu plugin

Tính Năng: Tài liệu API, tạo README, đồng bộ docs, xác thực

Commands: /generate-api-docs, /generate-readme, /sync-docs, /validate-docs

Cài Đặt: /plugin install documentation

Plus: README.md - Tổng quan plugins và hướng dẫn sử dụng


08. Checkpoints và Rewind (2 files)

Lưu trạng thái conversation và khám phá các cách tiếp cận thay thế.

File Mô Tả Nội Dung
README.md Tài liệu Hướng dẫn toàn diện về checkpoints
checkpoint-examples.md Ví dụ thực tế Database migration, tối ưu hóa hiệu năng, UI iteration, debug

Khái Niệm Chính:

  • Checkpoint: Snapshot của trạng thái conversation
  • Rewind: Trở về checkpoint trước đó
  • Branch Point: Khám phá nhiều cách tiếp cận

Cách Dùng:

# Checkpoints được tạo tự động với mỗi user prompt
# Để rewind, nhấn Esc hai lần hoặc dùng:
/rewind
# Sau đó chọn: Khôi phục code và conversation, Khôi phục conversation,
# Khôi phục code, Tóm tắt từ đây, hoặc Bỏ qua

Use Cases:

  • Thử các implementations khác nhau
  • Phục hồi từ lỗi
  • Thử nghiệm an toàn
  • So sánh giải pháp
  • A/B testing

09. Tính Nâng Cao (3 files)

Các khả năng nâng cao cho workflows phức tạp.

File Mô Tả Tính Năng
README.md Hướng dẫn hoàn chỉnh Tài liệu tất cả tính năng nâng cao
config-examples.json Ví dụ cấu hình 10+ cấu hình cụ thể theo use-case
planning-mode-examples.md Ví dụ lập kế hoạch REST API, database migration, refactoring
Scheduled Tasks Tasks định kỳ với /loop và cron tools Workflows định kỳ tự động
Chrome Integration Tự động hóa trình duyệt qua headless Chromium Testing và scraping web
Remote Control (expanded) Phương thức kết nối, bảo mật, bảng so sánh Quản lý session từ xa
Keyboard Customization Phím tắt tùy chỉnh, hỗ trợ chord, contexts Phím tắt cá nhân hóa
Desktop App (expanded) Connectors, launch.json, tính năng enterprise Tích hợp desktop

Tính Năng Nâng Cao Được Bao Phủ:

Planning Mode

  • Tạo kế hoạch triển khai chi tiết
  • Ước tính thời gian và đánh giá rủi ro
  • Phân tách task có hệ thống

Extended Thinking

  • Lý luận sâu cho vấn đề phức tạp
  • Phân tích quyết định kiến trúc
  • Đánh giá trade-off

Background Tasks

  • Operations dài hạn không chặn
  • Workflows phát triển song song
  • Quản lý và giám sát tasks

Permission Modes

  • default: Hỏi phê duyệt cho hành động rủi ro
  • acceptEdits: Tự động chấp nhận edits file, hỏi cho các khác
  • plan: Phân tích read-only, không sửa đổi
  • auto: Tự động phê duyệt hành động an toàn, hỏi cho rủi ro
  • dontAsk: Chấp nhận tất cả trừ rủi ro
  • bypassPermissions: Chấp nhận tất cả (yêu cầu --dangerously-skip-permissions)

Headless Mode (claude -p)

  • Tích hợp CI/CD
  • Thực thi task tự động
  • Xử lý hàng loạt

Session Management

  • Nhiều work sessions
  • Chuyển và lưu sessions
  • Session persistence

Interactive Features

  • Phím tắt
  • Lịch sử commands
  • Tab completion
  • Input đa dòng

Configuration

  • Quản lý settings toàn diện
  • Cấu hình cụ thể theo môi trường
  • Tùy chỉnh theo dự án

Scheduled Tasks

  • Tasks định kỳ với command /loop
  • Cron tools: CronCreate, CronList, CronDelete
  • Workflows định kỳ tự động

Chrome Integration

  • Tự động hóa trình duyệt qua headless Chromium
  • Khả năng testing và scraping web
  • Tương tác trang và trích xuất dữ liệu

Remote Control (expanded)

  • Phương thức và giao thức kết nối
  • Cân nhắc bảo mật và best practices
  • Bảng so sánh các tùy chọn truy cập từ xa

Keyboard Customization

  • Cấu hình keybinding tùy chỉnh
  • Hỗ trợ chord cho phím tắt đa-phím
  • Kích hoạt keybinding nhận biết ngữ cảnh

Desktop App (expanded)

  • Connectors cho tích hợp IDE
  • Cấu hình launch.json
  • Tính năng và triển khai enterprise

10. Sử Dụng CLI (1 file)

Các pattern và tham chiếu sử dụng giao diện dòng lệnh.

File Mô Tả Nội Dung
README.md Tài liệu CLI Flags, options, và patterns sử dụng

Tính Năng CLI Chính:

  • claude - Bắt đầu session tương tác
  • claude -p "prompt" - Mode headless/không-tương-tác
  • claude web - Khởi chạy web session
  • claude --model - Chọn model (Sonnet 4.6, Opus 4.6)
  • claude --permission-mode - Đặt permission mode
  • claude --remote - Bật điều khiển từ xa qua WebSocket

Files Tài Liệu (13 files)

File Vị Trí Mô Tả
README.md / Tổng quan ví dụ chính
INDEX.md / Danh mục hoàn chỉnh này
QUICK_REFERENCE.md / Tham khảo nhanh
README.md /01-slash-commands/ Hướng dẫn lệnh slash
README.md /02-memory/ Hướng dẫn bộ nhớ
README.md /03-skills/ Hướng dẫn skills
README.md /04-subagents/ Hướng dẫn tác nhân con
README.md /05-mcp/ Hướng dẫn MCP
README.md /06-hooks/ Hướng dẫn hooks
README.md /07-plugins/ Hướng dẫn plugins
README.md /08-checkpoints/ Hướng dẫn checkpoints
README.md /09-advanced-features/ Hướng dẫn tính năng nâng cao
README.md /10-cli/ Hướng dẫn CLI

Cây File Hoàn Chỉnh

claude-howto/
├── README.md                                    # Tổng quan chính
├── INDEX.md                                     # File này
├── QUICK_REFERENCE.md                           # Tham khảo nhanh
├── claude_concepts_guide.md                     # Hướng dẫn gốc
│
├── 01-slash-commands/                           # Lệnh Slash
│   ├── optimize.md
│   ├── pr.md
│   ├── generate-api-docs.md
│   ├── commit.md
│   ├── setup-ci-cd.md
│   ├── push-all.md
│   ├── unit-test-expand.md
│   ├── doc-refactor.md
│   ├── pr-slash-command.png
│   └── README.md
│
├── 02-memory/                                   # Bộ Nhớ
│   ├── project-CLAUDE.md
│   ├── directory-api-CLAUDE.md
│   ├── personal-CLAUDE.md
│   ├── memory-saved.png
│   ├── memory-ask-claude.png
│   └── README.md
│
├── 03-skills/                                   # Skills
│   ├── code-review/
│   │   ├── SKILL.md
│   │   ├── scripts/
│   │   │   ├── analyze-metrics.py
│   │   │   └── compare-complexity.py
│   │   └── templates/
│   │       ├── review-checklist.md
│   │       └── finding-template.md
│   ├── brand-voice/
│   │   ├── SKILL.md
│   │   ├── templates/
│   │   │   ├── email-template.txt
│   │   │   └── social-post-template.txt
│   │   └── tone-examples.md
│   ├── doc-generator/
│   │   ├── SKILL.md
│   │   └── generate-docs.py
│   ├── refactor/
│   │   ├── SKILL.md
│   │   ├── scripts/
│   │   │   ├── analyze-complexity.py
│   │   │   └── detect-smells.py
│   │   ├── references/
│   │   │   ├── code-smells.md
│   │   │   └── refactoring-catalog.md
│   │   └── templates/
│   │       └── refactoring-plan.md
│   ├── claude-md/
│   │   └── SKILL.md
│   ├── blog-draft/
│   │   ├── SKILL.md
│   │   └── templates/
│   │       ├── draft-template.md
│   │       └── outline-template.md
│   └── README.md
│
├── 04-subagents/                                # Tác Nhân Con
│   ├── code-reviewer.md
│   ├── test-engineer.md
│   ├── documentation-writer.md
│   ├── secure-reviewer.md
│   ├── implementation-agent.md
│   ├── debugger.md
│   ├── data-scientist.md
│   ├── clean-code-reviewer.md
│   └── README.md
│
├── 05-mcp/                                      # Giao Thức MCP
│   ├── github-mcp.json
│   ├── database-mcp.json
│   ├── filesystem-mcp.json
│   ├── multi-mcp.json
│   └── README.md
│
├── 06-hooks/                                    # Hooks
│   ├── format-code.sh
│   ├── pre-commit.sh
│   ├── security-scan.sh
│   ├── log-bash.sh
│   ├── validate-prompt.sh
│   ├── notify-team.sh
│   ├── context-tracker.py
│   ├── context-tracker-tiktoken.py
│   └── README.md
│
├── 07-plugins/                                  # Plugins
│   ├── pr-review/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   ├── commands/
│   │   │   ├── review-pr.md
│   │   │   ├── check-security.md
│   │   │   └── check-tests.md
│   │   ├── agents/
│   │   │   ├── security-reviewer.md
│   │   │   ├── test-checker.md
│   │   │   └── performance-analyzer.md
│   │   ├── mcp/
│   │   │   └── github-config.json
│   │   ├── hooks/
│   │   │   └── pre-review.js
│   │   └── README.md
│   ├── devops-automation/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   ├── commands/
│   │   │   ├── deploy.md
│   │   │   ├── rollback.md
│   │   │   ├── status.md
│   │   │   └── incident.md
│   │   ├── agents/
│   │   │   ├── deployment-specialist.md
│   │   │   ├── incident-commander.md
│   │   │   └── alert-analyzer.md
│   │   ├── mcp/
│   │   │   └── kubernetes-config.json
│   │   ├── hooks/
│   │   │   ├── pre-deploy.js
│   │   │   └── post-deploy.js
│   │   ├── scripts/
│   │   │   ├── deploy.sh
│   │   │   ├── rollback.sh
│   │   │   └── health-check.sh
│   │   └── README.md
│   ├── documentation/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   ├── commands/
│   │   │   ├── generate-api-docs.md
│   │   │   ├── generate-readme.md
│   │   │   ├── sync-docs.md
│   │   │   └── validate-docs.md
│   │   ├── agents/
│   │   │   ├── api-documenter.md
│   │   │   ├── code-commentator.md
│   │   │   └── example-generator.md
│   │   ├── mcp/
│   │   │   └── github-docs-config.json
│   │   ├── templates/
│   │   │   ├── api-endpoint.md
│   │   │   ├── function-docs.md
│   │   │   └── adr-template.md
│   │   └── README.md
│   └── README.md
│
├── 08-checkpoints/                              # Checkpoints
│   ├── checkpoint-examples.md
│   └── README.md
│
├── 09-advanced-features/                        # Tính Nâng Cao
│   ├── config-examples.json
│   ├── planning-mode-examples.md
│   └── README.md
│
└── 10-cli/                                      # Sử Dụng CLI
    └── README.md

Bắt Đầu Nhanh Theo Use Case

Chất Lượng & Reviews Code

# Cài đặt lệnh slash
cp 01-slash-commands/optimize.md .claude/commands/

# Cài đặt tác nhân con
cp 04-subagents/code-reviewer.md .claude/agents/

# Cài đặt skill
cp -r 03-skills/code-review ~/.claude/skills/

# Hoặc cài đặt plugin hoàn chỉnh
/plugin install pr-review

DevOps & Triển Khai

# Cài đặt plugin (bao gồm tất cả)
/plugin install devops-automation

Tài Liệu

# Cài đặt lệnh slash
cp 01-slash-commands/generate-api-docs.md .claude/commands/

# Cài đặt tác nhân con
cp 04-subagents/documentation-writer.md .claude/agents/

# Cài đặt skill
cp -r 03-skills/doc-generator ~/.claude/skills/

# Hoặc cài đặt plugin hoàn chỉnh
/plugin install documentation

Tiêu Chuẩn Nhóm

# Thiết lập bộ nhớ dự án
cp 02-memory/project-CLAUDE.md ./CLAUDE.md

# Chỉnh sửa để khớp với tiêu chuẩn nhóm của bạn

Tích Hợp Bên Ngoài

# Đặt biến môi trường
export GITHUB_TOKEN="your_token"
export DATABASE_URL="postgresql://..."

# Cài đặt config MCP (phạm vi dự án)
cp 05-mcp/multi-mcp.json .mcp.json

Tự Động Hóa & Xác Thực

# Cài đặt hooks
mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh

# Cấu hình hooks trong settings (~/.claude/settings.json)
# Xem 06-hooks/README.md

Thử Nghiệm An Toàn

# Checkpoints được tạo tự động với mỗi user prompt
# Để rewind: nhấn Esc+Esc hoặc dùng:
/rewind
# Sau đó chọn: Khôi phục code và conversation, Khôi phục conversation,
# Khôi phục code, Tóm tắt từ đây, hoặc Bỏ qua

# Xem 08-checkpoints/README.md cho ví dụ

Workflows Nâng Cao

# Cấu hình tính năng nâng cao
# Xem 09-advanced-features/config-examples.json

# Sử dụng planning mode
/plan Triển khai tính năng X

# Sử dụng permission modes
claude --permission-mode plan          # Cho review code (read-only)
claude --permission-mode acceptEdits   # Tự động chấp nhận edits
claude --permission-mode auto          # Tự động phê duyệt hành động an toàn

# Chạy trong mode headless cho CI/CD
claude -p "Chạy test và báo cáo kết quả"

# Chạy background tasks
Chạy test trong background

# Xem 09-advanced-features/README.md cho hướng dẫn hoàn chỉnh

Ma Trận Phủ Sở Tính Năng

Danh Mục Commands Agents MCP Hooks Scripts Templates Docs Images Tổng
01 Lệnh Slash 8 - - - - - 1 1 10
02 Bộ Nhớ - - - - - 3 1 2 6
03 Skills - - - - 5 9 1 - 28
04 Tác Nhân Con - 8 - - - - 1 - 9
05 MCP - - 4 - - - 1 - 5
06 Hooks - - - 8 - - 1 - 9
07 Plugins 11 9 3 3 3 3 4 - 40
08 Checkpoints - - - - - - 1 1 2
09 Nâng Cao - - - - - - 1 2 3
10 CLI - - - - - - 1 - 1

Lộ Trình Học Tập

Người Mới Bắt Đầu (Tuần 1)

  1. Đọc README.md
  2. Cài đặt 1-2 lệnh slash
  3. Tạo file bộ nhớ dự án
  4. Thử các commands cơ bản

Trung Cấp (Tuần 2-3)

  1. Thiết lập GitHub MCP
  2. Cài đặt một tác nhân con
  3. Thử ủy quyền tasks
  4. Cài đặt một skill

Nâng Cao (Tuần 4+)

  1. Cài đặt plugin hoàn chỉnh
  2. Tạo lệnh slash tùy chỉnh
  3. Tạo tác nhân con tùy chỉnh
  4. Tạo skill tùy chỉnh
  5. Xây dựng plugin của riêng bạn

Chuyên Gia (Tuần 5+)

  1. Thiết lập hooks cho tự động hóa
  2. Sử dụng checkpoints để thử nghiệm
  3. Cấu hình planning mode
  4. Sử dụng permission modes hiệu quả
  5. Thiết lập headless mode cho CI/CD
  6. Làm chủ session management

Tìm Kiếm Theo Từ Khóa

Hiệu Năng

  • 01-slash-commands/optimize.md - Phân tích hiệu năng
  • 04-subagents/code-reviewer.md - Review hiệu năng
  • 03-skills/code-review/ - Metrics hiệu năng
  • 07-plugins/pr-review/agents/performance-analyzer.md - Chuyên gia hiệu năng

Bảo Mật

  • 04-subagents/secure-reviewer.md - Review bảo mật
  • 03-skills/code-review/ - Phân tích bảo mật
  • 07-plugins/pr-review/ - Kiểm tra bảo mật

Testing

  • 04-subagents/test-engineer.md - Kỹ sư test
  • 07-plugins/pr-review/commands/check-tests.md - Độ phủ test

Tài Liệu

  • 01-slash-commands/generate-api-docs.md - Command tài liệu API
  • 04-subagents/documentation-writer.md - Tác nhân viết tài liệu
  • 03-skills/doc-generator/ - Skill tạo tài liệu
  • 07-plugins/documentation/ - Plugin tài liệu hoàn chỉnh

Triển Khai

  • 07-plugins/devops-automation/ - Giải pháp DevOps hoàn chỉnh

Tự Động Hóa

  • 06-hooks/ - Tự động hóa dựa trên sự kiện
  • 06-hooks/pre-commit.sh - Tự động hóa pre-commit
  • 06-hooks/format-code.sh - Tự động format
  • 09-advanced-features/ - Headless mode cho CI/CD

Xác Thực

  • 06-hooks/security-scan.sh - Xác thực bảo mật
  • 06-hooks/validate-prompt.sh - Xác thực prompt

Thử Nghiệm

  • 08-checkpoints/ - Thử nghiệm an toàn với rewind
  • 08-checkpoints/checkpoint-examples.md - Ví dụ thực tế

Lập Kế Hoạch

  • 09-advanced-features/planning-mode-examples.md - Ví dụ planning mode
  • 09-advanced-features/README.md - Extended thinking

Cấu Hình

  • 09-advanced-features/config-examples.json - Ví dụ cấu hình

Ghi Chú

  • Tất cả ví dụ đều sẵn sàng sử dụng
  • Chỉnh sửa để phù hợp với nhu cầu cụ thể của bạn
  • Ví dụ tuân theo best practices của Claude Code
  • Mỗi danh mục có README riêng với hướng dẫn chi tiết
  • Scripts bao gồm xử lý lỗi thích hợp
  • Templates có thể tùy chỉnh

Đóng Góp

Muốn thêm ví dụ nữa? Theo cấu trúc:

  1. Tạo thư mục con phù hợp
  2. Bao gồm README.md với hướng dẫn sử dụng
  3. Theo quy ước đặt tên
  4. Test kỹ lưỡng
  5. Cập nhật danh mục này

Cập Nhật Lần: Tháng 3 năm 2026 Tổng Số Ví Dụ: 100+ files Danh Mục: 10 tính năng Hooks: 8 scripts tự động hóa Ví Dụ Cấu Hình: 10+ scenarios Sẵn Sàng Sử Dụng: Tất cả ví dụ