รีวิว claude-code-infrastructure-showcase — ตัวอย่าง skills, hooks, agents ของ Claude Code จากงานจริง

คืออะไร

repo นี้เป็น คลังตัวอย่าง (reference library) สำหรับสร้าง infrastructure รอบ Claude Code ของตัวเอง ไม่ใช่แอปพร้อมใช้งาน — เจ้าของ repo ระบุชัดว่าต้อง copy ส่วนที่ต้องการไปใส่โปรเจกต์ตัวเอง เขียนด้วย TypeScript และมี MIT License

แนวคิดหลักมี 3 อย่าง

• Skill — คู่มือ markdown (patterns, conventions, examples) ที่ Claude จะโหลดมาเมื่อเกี่ยวข้องกับงาน
• Hook — script ที่ Claude Code รันอัตโนมัติในจังหวะสำคัญ (ทุก prompt, ก่อน/หลังการแก้ไขไฟล์)
• skill-rules.json — config ที่บอก hook ว่า prompt หรือไฟล์แบบไหนควร trigger skill ไหน

จุดเด่น

• แก้ปัญหาคลาสสิกของ Claude Code คือ "skills ไม่ activate อัตโนมัติ" — ใช้ UserPromptSubmit hook วิเคราะห์ prompt เช็ค file context แล้วแนะนำ skill ที่เกี่ยวข้องให้เอง
• แยกโหมดการจำแนกไว้ 3 แบบ: disabled (default, regex/keyword ล้วน ฟรี ใช้ออฟไลน์), fallback (AI ก่อน ถ้าล้มก็ fallback กลับไปใช้ regex), ai-only (AI อย่างเดียว)
• รองรับ AI provider 4 เจ้า — Gemini, OpenAI, Anthropic, Ollama (รัน local) พร้อม auto-detection เรียงลำดับ Gemini > OpenAI > Anthropic > Ollama
• มี setup wizard (setup.ts) ที่ copy ไฟล์, ตรวจ tech stack, ถามโหมดที่ต้องการ, ติดตั้ง dependency และตรวจงานของตัวเอง 8 health checks ก่อนประกาศว่าสำเร็จ
• แยก hook เป็น essential 4 ตัว (skill-activation-prompt, skill-verification-guard, skill-activation-tracker, post-tool-use-tracker) กับ optional ที่ติดตั้งเปิด/ปิดได้
• skill 4 ตัว, agent 8 ตัว (review architecture, refactor, debug error, research), slash command 4 ตัว (/dev-docs, /verify-setup ฯลฯ)
• มีระบบ dev docs ที่รอดจาก context reset และ pattern Modular Skills (500-Line Rule) ใช้ progressive disclosure เพื่อไม่ให้ context บวม
• มี health check แยกสำหรับเรียกซ้ำได้: bash .claude/scripts/verify-setup.sh พร้อมบอกคำสั่งแก้ไขเป็นรายข้อ ถ้าตรวจไม่ผ่าน
• README บอกว่าเกิดจากการใช้งานจริง 6 เดือนกับ 6 microservices, 50,000+ บรรทัด TypeScript, React frontend ที่มี data grid ซับซ้อน และ workflow engine
• อัปเดตโปรเจกต์เดิมปลอดภัย — รัน wizard ซ้ำจะไม่ copy ทับไฟล์เดิม ไม่ไปแตะ skill-rules.json ที่คุณ customize ไว้

เหมาะกับใคร

• คนที่ใช้ Claude Code อยู่แล้วแต่เจอปัญหา skill ต้องมาเรียกใช้เองทีละครั้ง อยากให้มัน activate อัตโนมัติ
• ทีมที่เขียน Node.js/Express/TypeScript, React/TypeScript/MUI v7 และมี Sentry อยู่แล้ว เพราะ skill ในคลังจับโค้ดส่วนนี้ไว้
• developer ที่อยากมี agent ช่วยงานเฉพาะทาง เช่น review architecture, วางแผน refactor, แก้ TypeScript error ให้อัตโนมัติ
• คนชอบลองของใหม่แบบออฟไลน์เป็นหลัก — โหมด default ใช้ regex ล้วน ไม่ต้องมี API key ก็ได้
• คนที่ชอบชุด editor ตามมาให้ด้วย มี NeoVim config สำหรับ prompt editing mode (Ctrl+G) ใส่ใน repo

เริ่มต้นใช้งาน

ต้องการ Node.js 18+ (แนะนำ 20+) กับ npm, ใช้บน macOS / Linux / WSL2 (hook เป็น bash script) และ jq ถ้าจะเปิด Stop hooks แบบ optional

แบบที่แนะนำ — ใช้ setup wizard:

# 1. Clone this repo
git clone https://github.com/diet103/claude-code-infrastructure-showcase.git

# 2. Run the setup wizard, pointing to YOUR project
cd claude-code-infrastructure-showcase
npx tsx setup.ts ~/my-project

wizard จะ detect tech stack ให้ ถามว่าใช้โหมด Classic (regex อย่างเดียว) หรือ AI-Enhanced ติดตั้ง dependency แล้วตรวจงานของตัวเอง 8 รายการ

ถ้าต้องการสั่งสคริปต์เอง หรือให้ Claude Code รันแทน ใช้ --yes:

npx tsx setup.ts ~/my-project --yes

แบบ manual (3 คำสั่ง):

# 1. Clone this repo
git clone https://github.com/diet103/claude-code-infrastructure-showcase.git

# 2. Copy .claude/ into YOUR project
cp -r claude-code-infrastructure-showcase/.claude ~/my-project/.claude

# 3. Install hook dependencies
cd ~/my-project/.claude/hooks && npm install && chmod +x *.sh

เช็กว่าใช้ได้ (ประมาณ 30 วินาที)

bash .claude/scripts/verify-setup.sh

ถ้าอยากเปิด AI classification (ไม่บังคับ):

# 1. Get a free Gemini API key: https://aistudio.google.com/apikey

# 2. Put it in the hooks .env file:
cp .claude/hooks/.env.example .claude/hooks/.env
# then open .claude/hooks/.env and uncomment: GEMINI_API_KEY=your-key-here
# (add .env to your project's .gitignore so you never commit it)

# 3. Enable AI mode - edit .claude/skills/skill-rules.json and change:
#   "skill_activation_mode": "disabled"  →  "skill_activation_mode": "fallback"

โหมด fallback จะ degrade ได้เสมอ คือถ้าไม่มี key, เน็ตล่ม, หรือ provider ช้า ก็ยังได้ regex matching กลับมา ไม่ทำให้ prompt พัง

ข้อควรรู้

• License: MIT License — ใช้เชิงพาณิชย์ได้ แต่ยังควรอ่านเงื่อนไขในไฟล์ LICENSE ก่อนใช้จริง
• ความสดใหม่: push ล่าสุด 14 ก.ค. 2026 | สร้าง repo เมื่อ 30 ต.ค. 2025 | อายุประมาณ 11 เดือน | ยังไม่ archived มี open issues 18 ราย | ดาว 10,034 / fork 1,220 (ข้อมูล ณ 3 ต.ค. 2026)
• ตัว repo เตือนเองว่าไม่ใช่แอปที่รันได้เลย ต้อง copy ไปใช้ ถ้าคาดหวังว่า clone มาแล้วจะใช้ทันที อาจผิดความคาดหมาย
• ใช้บน Windows ตรงๆ ไม่ได้ hook เป็น bash script ต้องใช้ WSL2
• บางส่วนยังต้องปรับเอง README ระบุชัดว่า settings.json, hook directory structures และตัวอย่างที่เขียนไว้บน blog domain ไม่ใช่ของที่ใช้ได้ทันที
• hook บางตัวหนัก tsc-check กับ trigger-build-resolver ระบุว่าเหมาะกับ monorepo เท่านั้น ถ้าโปรเจกต์เล็กอาจไม่ต้องเปิด
• ตัวอย่างเป็น generic blog domain ไม่ใช่ domain ของคุณ ต้องแก้เองก่อนใช้จริง
• มีโหมด AI เสริม ถ้าเปิดใช้จะมีค่าใช้จ่ายกับ API key (ยกเว้น Ollama ที่รัน local) และ ai-only ใช้ออฟไลน์ไม่ได้
• ต้องระวังเรื่อง API key ตัว README เตือนให้เพิ่ม .env ใน .gitignore ของโปรเจกต์ตัวเอง
• AI provider/model เป็นข้อมูล ณ ตอนเขียน README เช่น gemini-3-flash-preview, claude-haiku-4-5 อาจเปลี่ยนไปแล้ว ให้เช็กกับ provider ก่อนใช้งานจริง

🔗 https://github.com/diet103/claude-code-infrastructure-showcase

ข้อมูลจาก GitHub ณ 3 ต.ค. 2026: ⭐ 10,034 | ภาษา TypeScript | license MIT