mirror of
https://github.com/luongnv89/claude-howto.git
synced 2026-09-22 01:10:42 +02:00
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.
This commit is contained in:
Thiên Toán
+882
@@ -0,0 +1,882 @@
|
||||
<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>
|
||||
|
||||
# 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
|
||||
```bash
|
||||
# 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
|
||||
```bash
|
||||
# Cài đặt plugin (bao gồm tất cả)
|
||||
/plugin install devops-automation
|
||||
```
|
||||
|
||||
### Tài Liệu
|
||||
```bash
|
||||
# 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
|
||||
```bash
|
||||
# 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
|
||||
```bash
|
||||
# Đặ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
|
||||
```bash
|
||||
# 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
|
||||
```bash
|
||||
# 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
|
||||
```bash
|
||||
# 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ụ
|
||||
Reference in New Issue
Block a user