แม่แบบ Claude Code: สกิล เอเจนต์ ฮุค และอื่น ๆ

Claude Code Templates คืออะไร?

แม่แบบ Claude Code คือไฟล์การตั้งค่าที่นำกลับมาใช้ซ้ำได้ เพื่อปรับวิธีทำงานของ Claude Code ในโครงการหรือทั่วทั้งสภาพแวดล้อมเครื่องของคุณ

สิ่งสำคัญคือต้องเข้าใจว่าแม่แบบอิงกับไฟล์ ไม่ได้ติดตั้งผ่านหน้าตั้งค่าทั่วไปแล้วคลิกผ่านหน้าจอตั้งค่า แต่ Claude Code จะค้นหาไฟล์และโฟลเดอร์เฉพาะ โหลดเมทาดาทาที่เกี่ยวข้องเข้าในคอนเท็กซ์ และใช้ข้อมูลนั้นเพื่อตัดสินใจว่าจะทำงานอย่างไร

ในทางปฏิบัติ มักเป็นไฟล์ Markdown, JSON หรือเชลล์ จัดเก็บในโฟลเดอร์ระดับโครงการอย่าง .claude/ หรือแพ็กเป็นไดเรกทอรีสไตล์ปลั๊กอินเพื่อแชร์

โครงสร้างระดับโครงการทั่วไปอาจมีหน้าตาแบบนี้:

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

แม่แบบ Claude Code เทียบกับ CLAUDE.md

CLAUDE.md ยังสำคัญ แต่ทำหน้าที่ต่างกัน ให้คิดว่า CLAUDE.md คือบรีฟของโครงการ: โครงการคืออะไร มีคำสั่งใดสำคัญ มาตรฐานการเขียนโค้ดใดใช้บังคับ และแนวทางสถาปัตยกรรมใดที่ Claude ควรจำ

สำหรับคำแนะนำอย่างละเอียด ดู คู่มือการเขียน CLAUDE.md ของเรา

ส่วนแม่แบบจะมีความเป็นโมดูลาร์มากกว่า:

• สกิลสามารถเข้ารหัสเวิร์กโฟลว์การย้ายข้อมูลฐานข้อมูล
• เอเจนต์สามารถแยกบทบาทผู้ตรวจสอบความปลอดภัย
• ฮุคสามารถรันหลังการแก้ไขไฟล์
• การกำหนดค่า MCP สามารถเชื่อม Claude กับ GitHub, SQLite หรือระบบภายนอกอื่น

นี่เองที่แม่แบบเชื่อมกับการออกแบบเวิร์กโฟลว์ของ Claude Code ในภาพรวม แม่แบบที่ดีจะยิ่งได้ผลเมื่อจับคู่กับนิสัยที่ดีในการวางแผน ทดสอบ และส่งต่อคอนเท็กซ์

แนวทางปฏิบัติเหล่านี้มีอธิบายเพิ่มเติมใน คู่มือแนวปฏิบัติที่ดี ของเรา

คำสั่งแบบกำหนดเอง ก็ครอบคลุมอยู่ในระบบสกิลด้วย แม้รูปแบบเดิม .claude/commands/ จะยังใช้ได้ ฟอร์แมตใหม่ที่แนะนำคือ .claude/skills/<name>/SKILL.md ซึ่งรองรับทั้งการเรียกด้วยสแลชคอมมานด์และการเรียกอัตโนมัติโดย Claude

ฉันใช้แม่แบบ Claude Code แบบใดได้บ้าง?

ระบบนิเวศของแม่แบบ Claude Code มักจัดเป็น 6 หมวด: สกิล เอเจนต์ คำสั่ง ฮุค การผสาน MCP และปลั๊กอิน

ห้าประเภทแรกจะเปลี่ยนพฤติกรรมของ Claude โดยตรง ส่วนปลั๊กอินต่างออกไปเล็กน้อย: เป็นรูปแบบการกระจายที่สามารถรวมสกิล เอเจนต์ ฮุค คำสั่ง เซิร์ฟเวอร์ MCP และองค์ประกอบอื่น ๆ เข้าเป็นแพ็กเกจที่นำกลับมาใช้ซ้ำได้

เราจะพาไล่ดูแต่ละหมวดด้านล่าง

1. สกิล (Skills)

สกิลคือชุดคำสั่งสำหรับงานหลายขั้นตอนที่ทำซ้ำได้ โดยทั่วไปเป็นโฟลเดอร์ที่มีไฟล์ SKILL.md พร้อม YAML frontmatter และเนื้อหา Markdown

ส่วน frontmatter อธิบายว่าสกิลทำอะไรและควรทำงานอย่างไร ส่วนตัวเนื้อหาบอก Claude ให้ทำตามขั้นตอนใด หากต้องการเจาะลึกดูเพิ่มเติมได้ในคู่มือ Claude Skills

Claude ใช้คำอธิบายของสกิลเพื่อตัดสินว่าสกิลเกี่ยวข้องหรือไม่ โดยค่าเริ่มต้น ทั้งผู้ใช้และ Claude สามารถเรียกสกิลได้: พิมพ์ /skill-name หรือให้ Claude โหลดอัตโนมัติเมื่อภารกิจปัจจุบันตรงกับคำอธิบายสกิล นอกจากนี้ยังปิดการเรียกอัตโนมัติของโมเดลได้สำหรับเวิร์กโฟลว์ที่ต้องการควบคุมด้วยตนเอง เช่น การดีพลอย

ตัวอย่างสั้น ๆ ของไฟล์: .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

สิ่งนี้มีประโยชน์เพราะเป็นคำสั่งเชิงกระบวนการ ไม่ใช่แค่บอก Claude ให้ “ระวังตอนทำไมเกรชัน” แต่ให้เช็กลิสต์ที่ทำซ้ำได้

สกิลเหมาะกับทุกอย่างที่มิฉะนั้นจะต้องวางใส่ Claude ซ้ำเกินสองครั้ง: การสร้างเอ็นด์พอยต์ API การเขียนเชนจ์ล็อก การสคาฟโฟลด์เทสต์ การสร้างบันทึกเผยแพร่ ทบทวนพูลรีเควสต์ หรือการตรวจเช็กการย้ายข้อมูล

หากต้องการแรงบันดาลใจว่ามีนักพัฒนานำอะไรมาแปลงเป็นเวิร์กโฟลว์ AI ที่นำกลับมาใช้ซ้ำได้บ้าง ดูรายการ Agent Skills ของเรา

2. เอเจนต์ (Agents)

เอเจนต์ หรือให้ชัดคือซับเอเจนต์แบบกำหนดเองใน Claude Code คือผู้ช่วย AI เฉพาะทางที่มีไฟล์ Markdown ของตัวเอง พร้อม YAML frontmatter ข้อจำกัดเครื่องมือ การเลือกโมเดล และพรอมต์ระบบ

สามารถวางไว้ใน .claude/agents/ สำหรับขอบเขตโครงการ หรือ ~/.claude/agents/ สำหรับขอบเขตส่วนบุคคล สร้างเอเจนต์โดยให้ Claude ช่วยสร้างหรือแก้ไขไฟล์ markdown ในโฟลเดอร์ .claude/agents/ โดยตรง

สกิลกับเอเจนต์ต่างกันตรงที่ สกิลกำหนด “วิธีทำงาน” ส่วนเอเจนต์กำหนด “ตัวตนของ Claude ระหว่างทำงาน” ได้แก่ บทบาท โฟกัส การอนุญาต และขอบเขต

ลองดูตัวอย่างเอเจนต์นี้:

---
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.

เอเจนต์นี้มีประโยชน์เพราะให้ขอบเขตที่ชัดเจนกับ Claude ในเซสชันทั่วไป Claude อาจเผลอแก้ปัญหาทันทีที่พบ แต่เอเจนต์ผู้ตรวจสอบความปลอดภัยถูกสั่งให้ตรวจและรายงานเท่านั้น และหลีกเลี่ยงการแก้ไข

เอเจนต์เหมาะกับโดเมนเฉพาะ เช่น การตรวจสอบความปลอดภัย การทบทวนเอกสาร การทบทวนสถาปัตยกรรม วิศวกรรมข้อมูล หรือการตรวจคุณภาพโค้ด ซึ่งการแยกคอนเท็กซ์และขอบเขตการอนุญาตมีความสำคัญ

เอเจนต์ยังมีประโยชน์เมื่อจับคู่กับสกิลเฉพาะทาง เช่น เอเจนต์ผู้ตรวจสอบความปลอดภัยอาจเรียกใช้สกิลสรุปรายงานผล ในขณะที่เอเจนต์รีวิวฝั่งหน้าบ้านอาจใช้สกิลทดสอบคอมโพเนนต์

3. คำสั่ง (Commands)

คำสั่งคือช็อตคัตที่เรียกด้วยสแลช เช่น /generate-tests, /check-deps หรือ /summarize-pr เดิมที คำสั่งแบบกำหนดเองเก็บเป็นไฟล์ Markdown ใต้ .claude/commands/ โดยชื่อไฟล์เป็นชื่อคำสั่ง

Claude Code ยังรองรับรูปแบบเดิมนี้ แต่ขอแนะนำให้ใช้สกิลสำหรับเวิร์กโฟลว์ที่คล้ายคำสั่ง เพราะรองรับทั้งการเรียกแบบ /name และการเรียกอัตโนมัติเมื่อเหมาะสม

คำสั่งเหมาะเมื่ออยากให้ทริกเกอร์ชัดเจน สกิลอาจทำงานอัตโนมัติเมื่อ Claude ตรวจพบงานที่ตรงกัน แต่คำสั่งควรรันเฉพาะเมื่อคุณเลือก ทำให้มีประโยชน์เป็นจุดตรวจ เช่น “สร้างเทสต์ตอนนี้” “สรุป PR นี้ตอนนี้” “ตรวจสอบดีเพนเดนซีตอนนี้” หรือ “เตรียมข้อความคอมมิตตอนนี้”

4. ฮุค (Hooks)

ฮุคคือกฎอัตโนมัติที่รันตามเหตุการณ์ในวัฏจักรการทำงานของ Claude Code เป็นคำสั่งเชลล์ที่ผู้ใช้กำหนดเองให้ทำงาน ณ จุดต่าง ๆ ในวัฏจักรของ Claude Code เพื่อควบคุมพฤติกรรมแบบกำหนดได้แน่นอน

ความต่างจากแม่แบบก่อนหน้าอยู่ที่ฮุคไม่ได้ทริกเกอร์จากสิ่งที่คุณถาม แต่ทริกเกอร์จากสิ่งที่ Claude ทำ

พูดง่าย ๆ คือ ไม่ต้องหวังให้ Claude จำได้ว่าต้องจัดรูปแบบไฟล์หลังแก้ไข เพราะฮุคทำให้อัตโนมัติได้

ชื่ออีเวนต์ของฮุคปัจจุบันมีเช่น PreToolUse, PostToolUse, Notification และ Stop

ตัวอย่าง: รันตัวจัดรูปแบบหลัง Claude แก้ไขหรือเขียนไฟล์:

{
  "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"
          }
        ]
      }
    ]
  }
}

ฮุคเหมาะกับกฎที่ Claude ไม่ควรข้าม: รันลินเตอร์ จัดรูปแบบไฟล์ที่ถูกแก้ไข บล็อกการแก้ไฟล์ที่ป้องกันไว้ ตรวจสอบโค้ดที่สร้างขึ้น หรือส่งการแจ้งเตือนเมื่อ Claude ต้องการข้อมูลเพิ่ม

สำหรับบทเรียนเชิงลึก อ่าน คู่มือ Claude Code Hooks ของเรา

5. การผสาน MCP

การผสาน MCP เชื่อม Claude Code เข้ากับเครื่องมือ แหล่งข้อมูล และ API ภายนอกผ่าน Model Context Protocol โดย MCP ทำหน้าที่เป็นชั้นเชื่อมระหว่างระบบ AI กับเครื่องมือภายนอก ใน Claude Code หมายความว่า Claude ทำได้มากกว่าการอ่านไฟล์ในเครื่องและรันคำสั่งเชลล์

ช่วยให้ Claude โต้ตอบกับบริการภายนอกอย่าง GitHub ฐานข้อมูล ระบบเอกสาร แพลตฟอร์มคลาวด์ หรือ API ภายใน ขึ้นกับว่าได้ตั้งค่าเซิร์ฟเวอร์ MCP ใดไว้ สำหรับคำอธิบายครบถ้วนและโปรเจกต์เดโม ดูบทความ Model Context Protocol

เซิร์ฟเวอร์ MCP สามารถเปิดเผยความสามารถหลักได้สามแบบ:

• Tools: ฟังก์ชันที่รันได้ซึ่ง Claude เรียกใช้ได้ เช่น การสร้างอีชูบน GitHub หรือรันคิวรีฐานข้อมูล
• Resources: แหล่งคอนเท็กซ์แบบอ่านอย่างเดียว เช่น ไฟล์ แถวข้อมูลในฐานข้อมูล หรือเอกสาร
• Prompts: เทมเพลตงานที่นำกลับมาใช้ซ้ำได้ซึ่งเผยผ่านเซิร์ฟเวอร์

ไฟล์ .mcp.json ระดับโครงการอาจตั้งค่าเซิร์ฟเวอร์หลายตัวไว้ข้างกัน:

{
  "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"
      ]
    }
  }
}

สิ่งนี้สำคัญ เพราะ Claude ให้เหตุผลได้จากคอนเท็กซ์และเครื่องมือที่เข้าถึงเท่านั้น หากไม่มี MCP อาจตรวจไฟล์ในเครื่องได้ แต่ไม่ถึงตัวติดตามอีชู ฐานข้อมูล สภาพแวดล้อมคลาวด์ หรือ API ภายในของคุณ

MCP เหมาะเมื่อ Claude ต้องทำงานกับสแตกจริงแทนสแน็ปช็อตโค้ดคงที่ และเมื่อจำเป็นต้องเข้าถึงข้อมูลภายนอก

6. ปลั๊กอิน (Plugins)

ปลั๊กอินคือแพ็กเกจรวม สามารถรวมสกิล เอเจนต์ ฮุค การกำหนดค่า MCP คำสั่ง และองค์ประกอบอื่น ๆ ไว้ในโครงสร้างเดียวที่ติดตั้งได้

ใน Claude Code ปลั๊กอินมักมีไฟล์แมนิฟีสต์ .claude-plugin/plugin.json และโฟลเดอร์องค์ประกอบเช่น skills/, agents/, hooks/ และ .mcp.json ที่รากของปลั๊กอิน

ตัวอย่างโครงสร้างปลั๊กอิน:

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

ตัวอย่างไฟล์ plugin json:

{
  "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"
  }
}

ปลั๊กอินไม่ได้เพิ่มประเภทพฤติกรรมใหม่ แต่มอบความพกพาให้กับประเภทอื่น ๆ ใช้ปลั๊กอินเมื่ออยากแชร์การตั้งค่าครบชุดทั้งทีม ใช้เวิร์กโฟลว์เดียวกันข้ามโครงการ หรือเมื่อต้องการติดตั้งชุดที่ชุมชนดูแล แทนการสร้างไฟล์ทีละชิ้นด้วยตนเอง

หากต้องการสร้างตั้งแต่ต้น ดู คู่มือสร้างปลั๊กอิน Claude Code แบบทีละขั้น ของ DataCamp

ควรเลือกแม่แบบประเภทใด?

เข้าใจได้ว่าหลายประเภทอาจชวนงง ทั้งหมดต่างก็เปลี่ยนพฤติกรรมของ Claude ได้ ความต่างหลักอยู่ที่วิธีทริกเกอร์และระดับการควบคุมที่ให้มา

เพื่อให้ชัดเจนขึ้น นี่คือการเปรียบเทียบ:

กฎตัดสินใจง่าย ๆ ที่ช่วยได้:

• ถ้าต้องการบังคับใช้กฎอัตโนมัติทุกครั้งที่ Claude แตะโค้ด ให้ใช้ฮุค
• ถ้าอยากให้ Claude สวมความเชี่ยวชาญเฉพาะด้านลึกสำหรับงานเฉพาะ ให้ใช้เอเจนต์
• ถ้าต้องการเข้ารหัสเวิร์กโฟลว์ที่ Claude ควรทำซ้ำอย่างสม่ำเสมอ ให้ใช้สกิล
• ถ้าต้องการเรียกการกระทำด้วยตัวเองให้ถูกจังหวะ ใช้คำสั่งหรือสกิลแบบคำสั่ง
• ถ้า Claude ต้องการบริการภายนอกหรือข้อมูลสด ใช้MCP
• ถ้าต้องการติดตั้งหรือแชร์ชุดเวิร์กโฟลว์ครบ ใช้ปลั๊กอิน

ในโครงการจริง มักใช้หลายประเภทผสานกัน ปลั๊กอินด้านความปลอดภัยอาจรวมเอเจนต์ security-auditor สกิล audit-findings คำสั่งตรวจดีเพนเดนซี และพรีคอมมิตฮุค เอเจนต์กำหนดบทบาท สกิลกำหนดโครงรายงาน คำสั่งให้จุดตรวจชัดเจน และฮุคทำหน้าที่ราวกันตก

สำหรับเวิร์กโฟลว์ที่ Claude ควรทำตามแผนทางการก่อนการดำเนินการ การพัฒนาที่ขับเคลื่อนด้วยสเปก มักเหมาะกว่าการพรอมต์แบบเฉพาะกิจ

จะหาแม่แบบ Claude Code ได้จากที่ไหน?

มี 3 แหล่งที่ใช้ได้จริง: Anthropic ชุมชนคอลเลกชัน และตัวคุณเอง

อันดับแรก เริ่มจาก แหล่งข้อมูลทางการของ Anthropic และเอกสารกำกับ เอกสารของ Claude Code โดย Anthropic ครอบคลุมสกิล ซับเอเจนต์ ฮุค MCP และปลั๊กอิน และเป็นแหล่งที่ดีที่สุดในการยืนยันรูปแบบไฟล์และพฤติกรรมปัจจุบันก่อนเผยแพร่อะไรที่ใช้จริงในโปรดักชัน

ต่อมา ใช้ คอลเลกชันจากชุมชน ฮับชุมชนที่โดดเด่นที่สุดคือ aitmpl.com ซึ่งนิยามตนเองว่าเป็นแคตตาล็อกการตั้งค่าพร้อมใช้สำหรับโครงการ Claude Code เนวิเกชันสดขณะนี้รวมถึง Skills, Agents, Commands, Settings, Hooks, MCPs และ Plugins

คำสั่งติดตั้งแบบอินเทอร์แอคทีฟปัจจุบันคือ:

npx claude-code-templates@latest

เอกสารของโปรเจกต์ยังแสดงนามแฝงที่สั้นกว่า:

npx cct@latest

สำหรับองค์ประกอบเฉพาะ README บน GitHub แบบสดจะแสดงคำสั่งติดตั้งเช่น:

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

ยังมีตัวอย่างการติดตั้งแบบครั้งเดียวทั้งชุดด้วยแฟลกหลายรายการในคำสั่งเดียว

เมื่อประเมินแม่แบบจากชุมชน ให้ตรวจสัญญาณคุณภาพบางอย่าง:

• description จำเพาะพอไหมให้ Claude ทริกเกอร์สกิลหรือเอเจนต์ได้ถูกต้อง?

• allowed-tools ถูกจำกัดขอบเขตแคบหรือไม่ หรือขอสิทธิ์ write และ bash กว้างเกินจำเป็น?

• รีโพสิตอรีได้รับการดูแลล่าสุดเมื่อใด?

• แม่แบบอธิบายหรือไม่ว่ามันเปลี่ยนอะไร?

• มีฮุคหรือเซิร์ฟเวอร์ MCP ที่รันโค้ดที่คุณยังไม่ได้ตรวจทานหรือไม่?

สุดท้าย เขียนของตัวเอง มักเป็นคำตอบที่ถูกต้องสำหรับเวิร์กโฟลว์ที่ผูกกับสแตกของคุณอย่างแนบแน่น แม่แบบจากชุมชนอาจให้ฐานที่ดี แต่ย่อมไม่รู้แนวนโยบายไมเกรชันภายใน หลักการตั้งชื่อ โมเดลข้อมูล หรือระดับความเสี่ยงในการดีพลอยของคุณ

บทส่งท้าย

แม่แบบ Claude Code คือหนทางที่ทำให้ Claude Code ก้าวจากผู้ช่วยแบบรายเซสชัน ไปเป็นสภาพแวดล้อมพัฒนาที่คงอยู่ถาวร

หกหมวดที่กล่าวถึงจริง ๆ แล้วเป็นเลเยอร์: สกิลเข้ารหัสเวิร์กโฟลว์ เอเจนต์กำหนดบทบาท คำสั่งสร้างการกระทำที่ชัดเจน ฮุคบังคับใช้ราวกันตก MCP เชื่อมระบบภายนอก และปลั๊กอินแพ็กทุกอย่างเพื่อใช้ซ้ำ

จุดเริ่มต้นที่ดีที่สุดไม่ใช่สแตกปลั๊กอินขนาดใหญ่ ฉันจะเริ่มจากสกิลเดียวสำหรับเวิร์กโฟลว์ที่ทำซ้ำบ่อยที่สุด เมื่อเห็นว่าพฤติกรรมเริ่มต้นของ Claude ยังสร้างแรงเสียดทานตรงไหน ค่อยเพิ่มเอเจนต์เพื่อรีวิวเฉพาะทาง ฮุคเพื่อบังคับใช้ หรือเซิร์ฟเวอร์ MCP เพื่อเข้าถึงระบบสด

หากอยากเรียนรู้เพิ่มเติมเกี่ยวกับ Claude Code ลองดูคอร์ส Claude Code 101 และ Claude Code in Action ของเรา