Mẫu Claude Code: Kỹ năng, Tác nhân, Hook và hơn thế nữa

Claude Code Templates là gì?

Mẫu Claude Code là các tệp cấu hình có thể tái sử dụng để tuỳ biến cách Claude Code hoạt động trong một dự án hoặc trên toàn bộ môi trường cục bộ của bạn. 

Điều quan trọng cần hiểu là các mẫu dựa trên tệp. Bạn không cài đặt chúng qua giao diện cài đặt thông thường rồi bấm qua các màn hình cấu hình. Thay vào đó, Claude Code sẽ phát hiện các tệp và thư mục cụ thể, nạp siêu dữ liệu liên quan vào ngữ cảnh và dùng thông tin đó để quyết định cách hoạt động.

Trên thực tế, chúng thường là các tệp dạng Markdown, JSON, hoặc shell, được lưu trong các thư mục cấp dự án như .claude/, hoặc được đóng gói thành thư mục kiểu plugin để chia sẻ.

Một cấu trúc cấp dự án điển hình có thể trông như sau:

my-app/
├── CLAUDE.md
├── .mcp.json
└── .claude/
    ├── skills/
    │   └── database-migration/
    │       └── SKILL.md
    ├── agents/
    │   └── security-auditor.md
    ├── commands/
    │   └── summarize-pr.md
    └── settings.json

Mẫu Claude Code so với CLAUDE.md

CLAUDE.md vẫn quan trọng, nhưng đảm nhiệm vai trò khác. Hãy coi CLAUDE.md là bản tóm tắt dự án: dự án là gì, lệnh nào quan trọng, tiêu chuẩn mã hoá áp dụng ra sao, và các quy ước kiến trúc mà Claude cần ghi nhớ. 

Để có hướng dẫn chi tiết hơn, xem hướng dẫn viết CLAUDE.md của chúng tôi.

Các mẫu thì mô-đun hơn:

• Một kỹ năng có thể mã hoá quy trình migration. 
• Một tác nhân có thể cô lập nhân vật đánh giá bảo mật. 
• Một hook có thể chạy sau khi chỉnh sửa tệp. 
• Một cấu hình MCP có thể kết nối Claude với GitHub, SQLite, hoặc hệ thống bên ngoài khác.

Đây cũng là nơi các mẫu kết nối với thiết kế quy trình Claude Code rộng hơn. Các mẫu mạnh hoạt động tốt nhất khi đi cùng thói quen tốt trong lập kế hoạch, kiểm thử và bàn giao ngữ cảnh. 

Nhiều thực hành như vậy được trình bày chi tiết trong hướng dẫn thực hành tốt nhất của chúng tôi.

Lệnh tuỳ chỉnh cũng được bao phủ bởi hệ thống kỹ năng, dù định dạng cũ .claude/commands/ vẫn hoạt động. Định dạng mới được khuyến nghị là .claude/skills/<name>/SKILL.md, hỗ trợ gọi bằng lệnh gạch chéo và cho phép Claude tự động kích hoạt.

Tôi có thể dùng những loại mẫu Claude Code nào?

Hệ sinh thái mẫu Claude Code thường được tổ chức thành sáu nhóm: kỹ năng, tác nhân, lệnh, hook, tích hợp MCP và plugin. 

Năm loại đầu thay đổi trực tiếp hành vi của Claude. Plugin hơi khác: chúng là định dạng phân phối có thể đóng gói kỹ năng, tác nhân, hook, lệnh, máy chủ MCP và các thành phần khác thành gói có thể tái sử dụng.

Chúng ta sẽ xem từng nhóm bên dưới.

1. Kỹ năng (Skills)

Kỹ năng là các gói chỉ dẫn cho những tác vụ nhiều bước có thể lặp lại. Một kỹ năng thường là một thư mục chứa tệp SKILL.md với frontmatter YAML và phần thân Markdown. 

Frontmatter mô tả kỹ năng làm gì và nên hành xử ra sao; phần thân cho Claude biết các bước cần theo. Để tìm hiểu sâu, xem thêm trong hướng dẫn Claude Skills này.

Claude dùng phần mô tả của kỹ năng để quyết định khi nào kỹ năng có liên quan. Mặc định, cả người dùng lẫn Claude đều có thể kích hoạt kỹ năng: bạn có thể gõ /skill-name, hoặc Claude có thể tự nạp khi tác vụ hiện tại khớp mô tả kỹ năng. Bạn cũng có thể tắt việc mô hình tự động kích hoạt cho các quy trình bạn muốn kiểm soát thủ công, ví dụ như triển khai.

Đây là một ví dụ ngắn về tệp: .claude/skills/database-migration/SKILL.md

---
name: database-migration
description: Use when creating, reviewing, or modifying database migrations. Ensures migrations are reversible, tested, and checked before and after execution.
allowed-tools:
  - Read
  - Write
  - Bash
---

# Database Migration Skill

When working on a database migration:

1. Inspect the existing schema and migration history before writing changes.
2. Confirm whether the migration is additive, destructive, or data-transforming.
3. Create a reversible migration whenever the framework supports rollback.
4. Run the project’s migration check command before applying the migration.
5. Run tests that cover the affected models, queries, or API endpoints.
6. After writing the migration, summarize:
   - schema changes
   - rollback behavior
   - affected tables
   - test commands run

Điều này hữu ích vì chỉ dẫn mang tính thủ tục. Bạn không chỉ bảo Claude “hãy cẩn thận với migration.” Bạn đang đưa cho nó một checklist có thể lặp lại. 

Kỹ năng phù hợp nhất cho mọi thứ mà nếu không bạn sẽ phải dán vào Claude hơn hai lần: tạo endpoint API, viết changelog, dựng bộ kiểm thử, tạo ghi chú phát hành, rà soát pull request, hoặc kiểm tra migration.

Để có thêm cảm hứng về những gì nhà phát triển đang biến thành quy trình AI có thể tái sử dụng, xem danh sách Kỹ năng của Tác nhân của chúng tôi.

2. Tác nhân (Agents)

Tác nhân, chính xác hơn là subagent tuỳ chỉnh trong Claude Code, là các trợ lý AI chuyên biệt với định nghĩa Markdown riêng, frontmatter YAML, giới hạn công cụ, lựa chọn mô hình và system prompt riêng. 

Chúng có thể nằm trong .claude/agents/ cho phạm vi dự án hoặc ~/.claude/agents/ cho phạm vi cá nhân. Tác nhân được tạo bằng cách yêu cầu Claude hoặc chỉnh sửa trực tiếp các tệp markdown trong thư mục .claude/agents/.

Có sự khác biệt giữa kỹ năng và tác nhân. Kỹ năng định nghĩa cách thực hiện một tác vụ. Tác nhân định nghĩa Claude nên “là ai” khi làm việc: vai trò, trọng tâm, quyền hạn và ranh giới.

Hãy xem ví dụ về một tác nhân:

---
name: security-auditor
description: Reviews code for security vulnerabilities and produces a findings report without modifying files.
tools: Read, Glob, Grep, Bash
model: sonnet
---

You are a security auditor.

Your task is to inspect the codebase for vulnerabilities, risky patterns, and missing safeguards.

Rules:
- Do not edit files.
- Do not suggest broad rewrites unless directly tied to a security issue.
- Focus on authentication, authorization, input validation, secrets, dependency risk, and unsafe shell or SQL usage.
- Produce a findings report with severity, affected files, evidence, and recommended next steps.

Tác nhân này hữu ích vì nó đưa ra ranh giới rõ ràng cho Claude. Trong một phiên tổng quát, Claude có thể chuyển sang sửa lỗi ngay khi phát hiện. Tác nhân kiểm toán bảo mật được yêu cầu chỉ kiểm tra và báo cáo, tránh chỉnh sửa. 

Tác nhân phù hợp nhất cho các miền chuyên sâu như kiểm toán bảo mật, rà soát tài liệu, đánh giá kiến trúc, kỹ thuật dữ liệu, hoặc kiểm tra chất lượng mã, nơi việc cô lập ngữ cảnh và ràng buộc quyền hạn là quan trọng.

Tác nhân cũng hữu ích khi ghép với các kỹ năng chuyên biệt. Ví dụ, tác nhân kiểm toán bảo mật có thể gọi một kỹ năng lập báo cáo phát hiện, trong khi tác nhân rà soát frontend có thể dùng kỹ năng kiểm thử thành phần.

3. Lệnh (Commands)

Lệnh là các phím tắt gọi bằng gạch chéo như /generate-tests, /check-deps, hoặc /summarize-pr. Trước đây, lệnh tuỳ chỉnh được lưu dưới dạng tệp Markdown trong .claude/commands/, với tên tệp là tên lệnh. 

Claude Code vẫn hỗ trợ định dạng cũ này, nhưng tôi khuyến nghị dùng kỹ năng cho các quy trình giống lệnh mới, vì chúng hỗ trợ cùng cách gọi /name và có thể tự động kích hoạt khi phù hợp.

Lệnh phù hợp khi bạn muốn kích hoạt một cách rõ ràng. Một kỹ năng có thể tự động bật khi Claude phát hiện tác vụ phù hợp, nhưng một lệnh chỉ nên chạy khi bạn chọn. Điều đó khiến lệnh hữu ích như các điểm kiểm tra: “tạo kiểm thử ngay”, “tóm tắt PR này ngay”, “kiểm tra phụ thuộc ngay”, hoặc “chuẩn bị thông điệp commit ngay.”

4. Hook

Hook là các quy tắc tự động chạy để đáp ứng các sự kiện vòng đời của Claude Code. Chúng là các lệnh shell do người dùng định nghĩa, thực thi tại những thời điểm cụ thể trong vòng đời Claude Code, giúp kiểm soát hành vi một cách tất định. 

Khác với các mẫu đã nói ở trên, hook không được kích hoạt bởi những gì bạn yêu cầu, mà bởi những gì Claude thực hiện.

Nói đơn giản, bạn không cần hy vọng Claude nhớ định dạng tệp sau khi chỉnh sửa; một hook có thể làm việc đó tự động.

Các tên sự kiện hook hiện tại bao gồm những sự kiện như PreToolUse, PostToolUse, Notification và Stop. 

Ví dụ: chạy formatter sau khi Claude chỉnh sửa hoặc ghi tệp:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

Example: block risky shell commands before Claude runs them:
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 .claude/hooks/block-dangerous-bash.py"
          }
        ]
      }
    ]
  }
}

Hook phù hợp nhất cho các quy tắc mà Claude không được phép bỏ qua: chạy linter, định dạng tệp đã chỉnh sửa, chặn chỉnh sửa tệp được bảo vệ, kiểm tra mã sinh ra, hoặc gửi thông báo khi Claude cần đầu vào. 

Để có hướng dẫn chuyên sâu, đọc Hướng dẫn Claude Code Hooks của chúng tôi.

5. Tích hợp MCP

Tích hợp MCP kết nối Claude Code với công cụ, nguồn dữ liệu và API bên ngoài thông qua Model Context Protocol. MCP hoạt động như một lớp kết nối giữa hệ thống AI và công cụ bên ngoài. Trong Claude Code, điều này nghĩa là Claude có thể vượt ra ngoài các tệp cục bộ và lệnh shell. 

Nó cho phép Claude tương tác với các dịch vụ bên ngoài như GitHub, cơ sở dữ liệu, hệ thống tài liệu, nền tảng đám mây, hoặc API nội bộ, tuỳ vào máy chủ MCP bạn cấu hình. Để có giải thích đầy đủ và dự án demo, xem hướng dẫn Model Context Protocol của chúng tôi.

Một máy chủ MCP có thể cung cấp ba nhóm năng lực chính:

• Công cụ (Tools): các hàm có thể thực thi mà Claude có thể gọi, như tạo một issue trên GitHub hoặc chạy truy vấn cơ sở dữ liệu.
• Tài nguyên (Resources): nguồn ngữ cảnh chỉ đọc, như một tệp, một dòng dữ liệu, hoặc tài liệu.
• Prompt: mẫu tác vụ có thể tái sử dụng do máy chủ cung cấp.

Một .mcp.json cấp dự án có thể cấu hình nhiều máy chủ song song:

{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "sqlite": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sqlite",
        "./data/app.db"
      ]
    }
  }
}

Điều này quan trọng vì Claude chỉ có thể suy luận từ ngữ cảnh và công cụ mà nó truy cập được. Không có MCP, nó có thể xem các tệp cục bộ nhưng không thể truy cập bộ theo dõi issue, cơ sở dữ liệu, môi trường đám mây hoặc API nội bộ của bạn. 

MCP phù hợp nhất khi Claude cần làm việc với stack thực thay vì một ảnh chụp mã tĩnh và khi cần truy cập dữ liệu bên ngoài.

6. Plugin

Plugin là các gói đóng gói. Chúng có thể bao gồm kỹ năng, tác nhân, hook, cấu hình MCP, lệnh và các thành phần khác trong một cấu trúc có thể cài đặt duy nhất. 

Trong Claude Code, một plugin thường gồm tệp manifest .claude-plugin/plugin.json và các thư mục thành phần như skills/, agents/, hooks/ và .mcp.json ở thư mục gốc của plugin.

Ví dụ cấu trúc plugin:

frontend-workflow-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── component-test/
│       └── SKILL.md
├── agents/
│   └── frontend-reviewer.md
├── hooks/
│   └── hooks.json
└── .mcp.json

Ví dụ tệp json của plugin:

{
  "name": "frontend-workflow",
  "displayName": "Frontend Workflow",
  "version": "1.0.0",
  "description": "Frontend development workflow with review agents, test skills, and formatting hooks",
  "author": {
    "name": "Your Team"
  }
}

Plugin không bổ sung loại hành vi mới. Chúng giúp các loại khác trở nên di động. Hãy dùng plugin khi bạn muốn chia sẻ một thiết lập hoàn chỉnh trong nhóm, tái sử dụng cùng quy trình trên nhiều dự án, hoặc cài một gói do cộng đồng duy trì thay vì tự tạo từng tệp.

Để tự xây dựng từ đầu, xem Hướng dẫn từng bước về Claude Code Plugins của DataCamp.

Tôi nên chọn loại mẫu nào?

Tôi hoàn toàn hiểu; tất cả các loại này có thể gây rối. Chúng đều có thể thay đổi cách Claude hoạt động. Khác biệt chủ yếu nằm ở cách kích hoạt và mức kiểm soát mà chúng cung cấp.

Để dễ hình dung hơn, dưới đây là so sánh giữa chúng:

Một quy tắc quyết định đơn giản sẽ giúp ích:

• Nếu bạn muốn tự động cưỡng chế một quy tắc mỗi lần Claude chạm vào mã, hãy dùng hook. 
• Nếu bạn muốn Claude tiếp nhận chuyên môn sâu cho một tác vụ cụ thể, hãy dùng tác nhân. 
• Nếu bạn muốn mã hoá một quy trình Claude nên lặp lại một cách nhất quán, hãy dùng kỹ năng. 
• Nếu bạn muốn tự mình kích hoạt một hành động đúng thời điểm, hãy dùng lệnh hoặc kỹ năng dạng lệnh. 
• Nếu Claude cần dịch vụ bên ngoài hoặc dữ liệu trực tiếp, hãy dùng MCP. 
• Nếu bạn muốn cài đặt hoặc chia sẻ bộ thiết lập quy trình hoàn chỉnh, hãy dùng plugin.

Trong các dự án thực, những loại này thường được kết hợp. Một plugin bảo mật có thể đóng gói tác nhân security-auditor, kỹ năng audit-findings, một lệnh kiểm tra phụ thuộc và một hook pre-commit. Tác nhân định nghĩa vai trò, kỹ năng định nghĩa cấu trúc báo cáo, lệnh cho bạn một điểm kiểm tra rõ ràng, và hook thực thi hàng rào.

Với các quy trình mà Claude nên theo một kế hoạch chính thức trước khi triển khai, phát triển dẫn dắt bởi đặc tả thường phù hợp hơn so với nhắc lệnh tuỳ hứng.

Tôi có thể tìm mẫu Claude Code ở đâu?

Có ba nguồn thực tế: Anthropic, các bộ sưu tập cộng đồng và chính bạn.

Đầu tiên, hãy bắt đầu với tài nguyên chính thức của Anthropic và tài liệu. Tài liệu Claude Code của Anthropic bao gồm kỹ năng, subagent, hook, MCP và plugin, và là nơi tốt nhất để xác minh định dạng tệp và hành vi hiện tại trước khi xuất bản bất cứ thứ gì hướng tới sản xuất.

Thứ hai, hãy dùng bộ sưu tập cộng đồng. Trung tâm cộng đồng dễ thấy nhất là aitmpl.com, tự mô tả là danh mục các cấu hình sẵn sàng sử dụng cho dự án Claude Code. Điều hướng trực tiếp hiện bao gồm Skills, Agents, Commands, Settings, Hooks, MCPs và Plugins. 

Lệnh cài đặt tương tác hiện tại là:

npx claude-code-templates@latest

Tài liệu dự án cũng cho thấy một bí danh ngắn hơn:

npx cct@latest

Với các thành phần cụ thể, README GitHub trực tiếp hiển thị các lệnh cài đặt như sau:

npx claude-code-templates@latest --agent development-tools/code-reviewer --yes
npx claude-code-templates@latest --command performance/optimize-bundle --yes
npx claude-code-templates@latest --hook git/pre-commit-validation --yes
npx claude-code-templates@latest --mcp database/postgresql-integration --yes

Tài liệu cũng cho thấy cách cài đặt theo lô một full stack bằng nhiều cờ trong một lệnh duy nhất.

Khi đánh giá các mẫu cộng đồng, hãy kiểm tra một vài tín hiệu chất lượng:

• description có đủ cụ thể để Claude kích hoạt kỹ năng hoặc tác nhân đúng cách không?

• allowed-tools có được giới hạn hẹp không, hay mẫu yêu cầu quyền ghi và bash rộng không cần thiết?

• Kho lưu trữ có được bảo trì gần đây không?

• Mẫu có giải thích những gì nó thay đổi không?

• Nó có bao gồm hook hoặc máy chủ MCP thực thi mã mà bạn chưa rà soát không?

Thứ ba, tự viết. Đây thường là câu trả lời đúng cho các quy trình gắn chặt với stack của bạn. Một mẫu cộng đồng có thể cho bạn nền tảng hữu ích, nhưng không thể biết chính sách migration nội bộ, quy ước đặt tên, mô hình dữ liệu, hay mức chấp nhận rủi ro triển khai của bạn.

Lời kết

Mẫu Claude Code là cách Claude Code chuyển từ trợ lý theo từng phiên thành một môi trường phát triển bền bỉ. 

Sáu nhóm tôi đã đề cập thực chất là các lớp: kỹ năng mã hoá quy trình, tác nhân định nghĩa vai trò, lệnh tạo hành động rõ ràng, hook thực thi hàng rào, MCP kết nối hệ thống bên ngoài, và plugin đóng gói mọi thứ để tái sử dụng.

Nơi bắt đầu tốt nhất không phải là một chồng plugin khổng lồ. Tôi sẽ bắt đầu với một kỹ năng cho quy trình bạn lặp lại nhiều nhất. Khi bạn thấy nơi nào hành vi mặc định của Claude vẫn gây ma sát, hãy thêm một tác nhân cho rà soát chuyên biệt, một hook để cưỡng chế, hoặc một máy chủ MCP để truy cập hệ thống trực tiếp.

Để học thêm về Claude Code, xem các khoá học Claude Code 101 và Claude Code trong thực tiễn của chúng tôi.