เจาะลึกสถาปัตยกรรม Command-Agent-Skill: เปลี่ยน Claude Code จากแชทบอทให้กลายเป็นทีมพัฒนาอัตโนมัติ

Claude Code เพิ่งเปลี่ยนโลกการเขียนโค้ดของผมไปเลยครับ หลังจากที่ผมไปขุดเจอ Repository ชื่อ shanraisshan/claude-code-best-practice ที่เคยขึ้นอันดับ 1 ใน GitHub Trending มา มันทำให้ผมรู้ว่าที่เราใช้ Claude Code กันอยู่ทุกวันนี้ เป็นเพียงแค่ยอดภูเขาน้ำแข็งเท่านั้นครับ

คนส่วนใหญ่ใช้ Claude Code เหมือนใช้ ChatGPT คือพิมพ์สั่งไปเรื่อยๆ ในหน้าแชทเดิม แต่รู้ไหมครับว่าเบื้องหลังของมันถูกออกแบบมาให้เป็น "ระบบปฏิบัติการสำหรับการพัฒนาซอฟต์แวร์" ที่มีโครงสร้างซับซ้อนและทรงพลังมาก โดยเฉพาะสถาปัตยกรรมที่เรียกว่า Command → Agent → Skill ซึ่งเป็นกุญแจสำคัญที่ทำให้ Claude สามารถทำงานแทนเราได้เป็นชั่วโมงๆ โดยไม่หลงทาง

บทความนี้ผมจะพาคุณไปขุดไส้ในของสถาปัตยกรรมนี้ พร้อมสอนวิธีเซ็ตระบบให้ Claude Code กลายเป็นทีม Developer ที่มีทั้งหัวหน้าทีม (Commands), ผู้เชี่ยวชาญเฉพาะทาง (Agents) และคู่มือการทำงาน (Skills) แบบละเอียดยิบที่หาอ่านที่ไหนไม่ได้ในไทยครับ

สิ่งที่ต้องเตรียมก่อนเริ่ม

ก่อนที่เราจะไปลงมือทำ คุณต้องมั่นใจก่อนว่ามีเครื่องมือเหล่านี้พร้อมอยู่บนเครื่องครับ:

1. Claude Code CLI: ติดตั้งผ่าน npm install -g @anthropic-ai/claude-code (ต้องเป็นเวอร์ชันล่าสุดเสมอครับ เพราะฟีเจอร์ใหม่ๆ มาเร็วมาก)
2. Git: โปรเจกต์ที่คุณจะใช้ต้องมีการทำ Git ไว้ เพราะ Claude Code อาศัย Git ในการทำงานหลายอย่าง โดยเฉพาะการแยกสาขา (Worktrees)
3. ความเข้าใจพื้นฐานเรื่อง YAML: เพราะเราจะใช้เขียน Config หลักของระบบครับ

สถาปัตยกรรม 3 ประสาน: Command, Agent, Skill คืออะไร?

ก่อนจะไปดูโค้ด ผมอยากให้คุณเห็นภาพรวมก่อน ผมขอเปรียบเทียบ Claude Code เหมือนกับ "บริษัทพัฒนาซอฟต์แวร์" หนึ่งบริษัทครับ

1. Commands (คำสั่ง): เหมือนการตะโกนสั่งงานในห้องทำงานเดียวกัน ทุกคนได้ยินเหมือนกัน ใช้บริบท (Context) ร่วมกัน เหมาะกับการสั่งงานสั้นๆ เร็วๆ เช่น "เช็คโค้ดส่วนนี้ให้หน่อย" หรือ "ทำ Unit Test ให้ไฟล์นี้ที"
2. Agents (ตัวแทนอัตโนมัติ): เหมือนการจ้างฟรีแลนซ์หรือผู้เชี่ยวชาญเฉพาะทางแยกห้องทำงานไปเลยครับ เขามีเครื่องมือของตัวเอง มีสิทธิ์เข้าถึงเฉพาะที่ได้รับอนุญาต และทำงานในบริบทที่สะอาด (Fresh Context) ไม่ปนกับเรื่องจิปาถะที่เราคุยค้างไว้ในแชทหลัก
3. Skills (ทักษะ): เหมือนกับคู่มือ SOP (Standard Operating Procedure) ของบริษัท เป็นคลังความรู้ที่บอกว่า "ถ้าจะทำเรื่อง X ต้องทำขั้นตอน 1-2-3 แบบนี้นะ" ซึ่งทั้ง Commands และ Agents สามารถเดินมาหยิบคู่มือนี้ไปใช้ได้

จุดเด่นที่สุดคือ Skills ตามมาตรฐาน Agent Skills (agentskills.io) สามารถนำไปใช้ข้ามเครื่องมือได้ ทั้งใน Claude Code, Cursor, Gemini CLI หรือแม้แต่ IDE ตัวใหม่อย่าง Antigravity ครับ

1. Commands: หัวหน้าทีมสั่งการไว

Commands คือสิ่งที่เรียกใช้ผ่าน /ชื่อคำสั่ง ในหน้าแชท เดิมที Commands จะแยกไฟล์ชัดเจน แต่ในเวอร์ชันล่าสุด Anthropic ได้รวม Commands เข้ากับ Skills แล้วครับ (แต่ยังรองรับรูปแบบเดิมอยู่เพื่อความสะดวก)

ตัวอย่างการสร้าง Custom Command:
ให้คุณสร้างไฟล์ที่ .claude/commands/refactor.md (หรือใช้โครงสร้าง Skill ก็ได้) แล้วใส่ Prompt ลงไปแบบนี้ครับ:

# Refactor Command

ทบทวนโค้ดในไฟล์ที่เลือก โดยยึดหลักการ Clean Code:
1. ลดความซับซ้อนของ Logic (Cyclomatic Complexity)
2. แยกฟังก์ชันที่ใหญ่เกินไปออกเป็นส่วนย่อย
3. ตรวจสอบการตั้งชื่อตัวแปรให้สื่อความหมาย

ห้ามทำการเปลี่ยนแปลงจนกว่าผมจะยืนยันแผนการทำ Refactor ก่อน

เมื่อคุณพิมพ์ /refactor ใน Claude Code มันจะฉีด Prompt นี้เข้าไปในบทสนทนาปัจจุบันทันที ข้อดีคือมัน "Cheap and Fast" เพราะไม่ต้องเปิด Session ใหม่ แต่ข้อเสียคือถ้าแชทคุณยาวมากแล้ว (Context บวม) Claude อาจจะเริ่มเบลอได้ครับ

2. Agents: ผู้เชี่ยวชาญในห้องปิดตาย

นี่คือจุดที่สนุกที่สุดครับ Agents ใน Claude Code ไม่ได้เป็นแค่แชทบอท แต่มันคือ Autonomous Actor ที่รันในห้องแยก (Isolated Context) มี Identity ของตัวเอง และที่สำคัญคือเรากำหนดได้ว่ามันจะใช้ Model ตัวไหน (เช่น ใช้ Haiku เพื่อความประหยัด หรือ Sonnet เพื่อความฉลาด)

วิธีสร้าง Custom Agent:
สร้างไฟล์ .claude/agents/security-reviewer.md พร้อมใส่ YAML Frontmatter เพื่อกำหนดค่าพลังครับ:

---
name: security-reviewer
description: ผู้เชี่ยวชาญด้านความปลอดภัย ค้นหาช่องโหว่ OWASP Top 10
model: claude-3-5-sonnet-latest
permissionMode: plan
tools: [read_file, grep_search, glob]
disallowedTools: [edit_file, run_shell_command]
memory: project
---

คุณคือหัวหน้าทีม Security Audit หน้าที่ของคุณคือสแกนหาช่องโหว่ในโค้ด
โดยเฉพาะจุดที่มีการรับ Input จาก User และการจัดการ Credential
ห้ามทำการแก้ไขโค้ดโดยพลการ ให้ทำ Report ออกมาเป็น Markdown เท่านั้น

คำอธิบายพารามิเตอร์ที่น่าสนใจ:
- permissionMode: plan: หมายความว่า Agent ตัวนี้จะมีสิทธิ์อ่านอย่างเดียว (Read-only) เหมาะกับการทำ Research
- disallowedTools: เราสั่งห้ามไม่ให้มันแก้ไขไฟล์หรือรันคำสั่ง Shell เพื่อความปลอดภัย
- memory: project: Agent ตัวนี้จะจำสิ่งที่เคยทำไว้ในโปรเจกต์นี้ได้ แม้เราจะปิด Session ไปแล้วก็ตาม

เทคนิคจากโปรเจกต์ระดับโลก: อย่าสร้าง Agent แบบกว้างๆ เช่น "Backend Engineer" ให้สร้างเป็น Agent เฉพาะเรื่อง เช่น "Auth-Validator" หรือ "SQL-Optimizer" จะได้ผลลัพธ์ที่แม่นยำกว่ามากครับ

3. Skills: คู่มือปฏิบัติงานอัจฉริยะ

Skills คือหัวใจของความยืดหยุ่นครับ มันคือโฟลเดอร์ที่เก็บทั้งคำสั่ง, ตัวอย่างโค้ด, และสคริปต์ที่จำเป็นไว้ด้วยกัน โดยมีไฟล์หลักคือ SKILL.md

โครงสร้างโฟลเดอร์ของ Skill:

.claude/skills/deploy/
├── SKILL.md          # ไฟล์หลักเก็บ Prompt และ Config
├── references/       # เก็บเอกสารประกอบ (PDF, MD)
├── scripts/          # สคริปต์ที่ Claude สามารถหยิบไปรันได้
└── examples/         # ตัวอย่างโค้ดที่ถูกต้อง (Golden Examples)

หัวใจสำคัญคือไฟล์ SKILL.md:

---
name: deploy
description: คู่มือการ Deploy งานขึ้น Production ตามมาตรฐานบริษัท
context: fork
agent: general-purpose
shell: bash
---

ใช้สคริปต์ใน `scripts/check-env.sh` เพื่อตรวจสอบความพร้อมก่อน
จากนั้นรันคำสั่ง `!`npm run build`` เพื่อทดสอบ Build ในเครื่อง

หากผ่านทั้งหมด ให้ทำตามขั้นตอนการ Deploy ต่อไปนี้...
$ARGUMENTS

ฟีเจอร์เด็ดของ Skills ที่คุณต้องรู้:
1. Context Forking (context: fork): เมื่อเรียกใช้ Skill นี้ Claude จะแตกหน่อ (Fork) ไปรันใน Agent ใหม่ทันที ทำให้แชทหลักของเราไม่รก
2. Dynamic Injection (!command``): เราสามารถใส่คำสั่ง Shell ใน Backticks นำหน้าด้วยเครื่องหมายตกใจ เพื่อให้ระบบรันคำสั่งนั้น "ก่อน" ที่จะส่ง Prompt ให้ Claude ครับ เช่น !`git diff main` เพื่อส่งส่วนต่างของโค้ดไปให้ Claude วิเคราะห์ทันที
3. Progressive Disclosure: Claude จะไม่อ่านไฟล์ทั้งหมดในโฟลเดอร์ Skill ทันที แต่จะอ่านแค่คำอธิบาย (Description) ก่อน ถ้ามันเห็นว่าจำเป็นค่อยไปเจาะอ่านไฟล์อื่นๆ ช่วยประหยัด Token ได้มหาศาลครับ

ถอดบทเรียนจาก 9 สุดยอด Workflow ของโลก

ใน Repo claude-code-best-practice เขาได้รวบรวมและเปรียบเทียบ 9 วิธีการรันทีม Agentic Workflow ไว้ครับ ผมสรุปตัวที่เด่นๆ มาให้ดูว่าเขาเทพกันขนาดไหน:

1. Superpowers (121k stars) - สาย TDD ตัวพ่อ
หัวใจของทีมนี้คือ "Iron Laws" หรือกฎเหล็กครับ เขาบังคับว่าต้องเขียน Test ก่อนเสมอ (Test-Driven Development) โดยมีขั้นตอน 7 เฟส ตั้งแต่ระดมสมองไปจนถึงการรัน Git Worktrees แยกสาขาเพื่อไม่ให้งานปนกัน เขาพิสูจน์แล้วว่าถ้าเซ็ตระบบดีๆ Claude สามารถทำงานต่อเนื่องได้นานถึง 2 ชั่วโมงโดยไม่ออกนอกลู่นอกทางเลยครับ

2. Get Shit Done (44k stars) - สายซัดแหลก (Wave Execution)
ทีมนี้เน้นความเร็วครับ เขาใช้สิ่งที่เรียกว่า "Wave Execution" คือการล้าง Context ทิ้งทุกครั้งที่เริ่มงานชิ้นใหม่ (Fresh 200K-token contexts) เพื่อให้ Claude ฉลาดที่สุดตลอดเวลา ไม่เก็บขยะจากแชทเก่ามาคิดให้ปวดหัว

3. BMAD-METHOD (43k stars) - สายครบวงจร (Full SDLC)
ทีมนี้เน้นสร้าง Agent Persona ขึ้นมาทำหน้าที่แทนคนในทุกตำแหน่ง ตั้งแต่คนเขียน PRD, ดีไซน์เนอร์, ไปจนถึง QA โดยใช้ Skills กว่า 43 ชุดในการควบคุมคุณภาพงาน

สรุป Insight สำคัญ: ไม่ว่าคุณจะเลือกสายไหน ทั้ง 9 ทีมมีสิ่งที่เหมือนกันคือโฟลว์ Research → Plan → Execute → Review → Ship ครับ ห้ามข้ามขั้นตอนเด็ดขาด!

86 เคล็ดลับจากผู้สร้าง (Tips & Tricks)

ผมคัดเน้นๆ เฉพาะตัวที่จะช่วยให้คุณทำงานง่ายขึ้นทันทีมาให้ครับ:

- เลี่ยงช่วง "เอ๋อ" (Agent Dumb Zone): เมื่อบริบท (Context) ของ Claude ถูกบีบอัด (Compaction) เกิน 50% ความฉลาดจะลดลงอย่างเห็นได้ชัดครับ ถ้าเริ่มคุยไม่รู้เรื่องให้ใช้คำสั่ง /clear เพื่อเริ่ม Session ใหม่ทันที

- อย่า Micro-manage: เชื่อไหมครับว่า Claude แก้บั๊กเก่งที่สุดตอนที่เราแปะ Error ลงไปแล้วบอกสั้นๆ ว่า "Fix" โดยไม่ต้องสอนว่าต้องแก้ตรงไหน ปล่อยให้มันคิดเองจะได้ผลลัพธ์ที่ดีกว่า

- ใช้ /batch สำหรับงานกรรมกร: ถ้าต้องแก้โค้ดที่เหมือนๆ กันทั้งโปรเจกต์ 20-30 ไฟล์ ให้ใช้คำสั่ง /batch ครับ มันจะแตก Worker ออกมาทำงานขนานกัน (Parallel) ใน Git Worktree แยกกัน แล้วเปิด PR มาให้เราตรวจทีเดียว

- ASCII Diagram คืออาวุธลับ: เวลาจะอธิบายสถาปัตยกรรมที่ซับซ้อนให้ Claude ฟัง การวาดแผนผังด้วยตัวอักษร ASCII ช่วยให้มันเข้าใจ Dependency ได้ดีกว่าการพิมพ์อธิบายยาวๆ ครับ

ปัญหาที่พบบ่อย + วิธีแก้

ปัญหา: สร้าง Agent แล้วมันรันคำสั่งอันตราย เช่นลบไฟล์ทิ้ง
วิธีแก้: ใช้ permissionMode: plan ในการรันครั้งแรกเพื่อให้มันแค่เสนอแผน (Read-only) หรือระบุ disallowedTools ใน YAML ให้ชัดเจนครับ

ปัญหา: Claude เริ่มสับสนเมื่อโปรเจกต์ใหญ่ขึ้น (Monorepo)
วิธีแก้: สร้างไฟล์ CLAUDE.md แยกตามโฟลเดอร์ย่อยครับ ระบบจะโหลดเฉพาะกฎที่เกี่ยวข้องกับโฟลเดอร์นั้นๆ มาทำงาน ช่วยลดสัญญาณรบกวนได้ดีมาก

ปัญหา: เรียกใช้ Skill แล้วหาไฟล์ไม่เจอ
วิธีแก้: ตรวจสอบว่าได้ตั้งชื่อโฟลเดอร์ Skill ตรงกับค่า name: ใน YAML หรือไม่ และควรใช้ Variable ${CLAUDE_SKILL_DIR} ในการอ้างอิง Path ภายใน Skill ครับ

สรุป: สู่ยุคของ AI-First Development

การเปลี่ยนจากการ "แชท" มาเป็นการ "สร้างระบบ" ด้วย Command → Agent → Skill คือจุดเปลี่ยนสำคัญที่จะทำให้คุณทำงานได้เร็วขึ้นอย่างน้อย 3-5 เท่าครับ มันไม่ใช่แค่เรื่องของความสะดวก แต่มันคือการสร้างทีมพัฒนาที่ทำงานได้ 24/7 โดยไม่มีข้อผิดพลาดจากความเหนื่อยล้า

ถ้าให้ผมแนะนำ Next Step ลองเริ่มจากการสร้าง Personal Skills ของตัวเองก่อนครับ เช่น Skill ในการทำ Code Review ตามสไตล์ที่คุณชอบ หรือ Skill ในการช่วยเขียน Git Commit Message ที่ตรงตามมาตรฐานของบริษัท แล้วคุณจะพบว่า Claude Code ไม่ใช่แค่เครื่องมือช่วยเขียนโค้ด แต่เป็นคู่หูที่รู้ใจคุณที่สุดในฐานะ Developer ครับ

ผมขุดข้อมูลมาให้เท่านี้ ที่เหลืออยู่ที่คุณจะเอาไปประยุกต์ใช้แล้วล่ะครับ ขอให้สนุกกับการสร้างทีม AI ของตัวเองนะ!

แหล่งอ้างอิง

• shanraisshan/claude-code-best-practice — GitHub Repository
• obra/superpowers — GitHub Repository
• Claude Code Official Docs — Extend Claude with Skills
• Claude Code Official Docs — Create Custom Subagents