คู่มือ Agent — เริ่มที่นี่
ภาพรวมทีม agent ทั้งชุด: อะไรคือ skill อะไรคือ agent, งานแบบไหนเรียกตัวไหน, กติกาที่ใช้ร่วมกันทุกตัว และ plugin ที่เปิด/ปิดอยู่จริงตอนนี้
อัปเดต: 2026-08-06
คู่มือชุดนี้อธิบาย ทีม agent ทั้งหมดที่ติดตั้งอยู่บนเครื่องนี้ — ตัวไหนทำอะไร เรียกยังไง ต้องป้อนอะไรให้ ได้อะไรกลับมา และห้ามใช้ทำอะไร
ที่มาของข้อมูล: repo Agents (C:\SourceCode\Private\Agents) — อ่านจาก SKILL.md / agent frontmatter / core/contracts/*.yaml จริง ไม่ได้เขียนจากความจำ
1. โครงสร้าง 3 ชั้น — สิ่งที่พิมพ์ กับ สิ่งที่วิ่งข้างล่าง
จุดที่สับสนบ่อยที่สุดคือ “agent” กับ “skill” ไม่ใช่ของอย่างเดียวกัน
flowchart TD
O["Owner พิมพ์คำสั่ง<br/>เช่น /dev-team, /coding"] --> S["ชั้น 1 — SKILL<br/>สิ่งที่เรียกได้จริง 27 ตัว"]
S --> M["ชั้น 2 — ORCHESTRATOR<br/>ทำงานบน main thread<br/>ถาม/วางแผน/ตัดสินใจ/สรุป"]
M --> A["ชั้น 3 — AGENT (subagent)<br/>36 ตัว ถูก spawn ทีละ call<br/>stateless ทำงานเดียวจบ"]
A --> M
M --> R["รายงานกลับ Owner<br/>ภาษาไทยเสมอ"]| ชั้น | คืออะไร | จำนวน | Owner เรียกตรงไหม |
|---|---|---|---|
| Skill | ชุดคำสั่งที่พิมพ์เรียกได้ (/dev-team, /coding, /counsel) | 27 | ✅ ใช่ — นี่คือประตูเข้า |
| Orchestrator | ตัวที่วิ่งบน main thread หลังเรียก skill | — | ❌ เป็นผลจาก skill |
| Agent | subagent ที่ถูก spawn ไปทำงานย่อย แล้วคืนผลลัพธ์ | 36 | ⚠️ ได้ แต่ไม่ใช่ทางหลัก |
ข้อสำคัญ: agent ส่วนใหญ่ (โดยเฉพาะ 26 ตัวของ dev-team) ไม่ได้ออกแบบมาให้เรียกตรง — มันคาดหวัง Task Contract, decision.yaml, run directory ที่ orchestrator เตรียมให้ ถ้าอยากได้ agent เดี่ยวๆ ให้ใช้ specialists ซึ่งเป็น skill ที่ห่อ agent ตัวนั้นไว้พร้อม input contract ครบ
2. งานแบบนี้ → เรียกอะไร
ตารางเดียวที่ควรจำ ที่เหลืออ่านเมื่อต้องใช้
| อยากได้อะไร | เรียก | อ่านต่อ |
|---|---|---|
| งานพัฒนาจริง แตะหลายไฟล์/หลาย lane ต้องมีหลักฐาน | /dev-team | dev-team |
| งานโค้ดเล็ก ≤ 2-5 ไฟล์ ขอบเขตชัด / prototype | /coding | orchestrator เบา |
| เขียน test อย่างเดียว ห้ามแตะ production code | /qa-team | ทีมพี่น้อง |
| ไอเดียยังไม่ชัด อยากได้ options หรือ spec ก่อนลงมือ | /requirement-team | ทีมพี่น้อง |
| อยากได้ความเห็นที่สอง ก่อนตัดสินใจ (เก็บเข้า archive) | /advisor-team | ทีมพี่น้อง |
| ถามอย่างเดียวจบ ไม่ต้องมีพิธี (review diff, ถาม repo, เช็ค security) | /<ชื่อ specialist> | specialists 17 ตัว |
| Mockup UI / diagram / design spec | /design | orchestrator เบา |
| เขียนเอกสารจาก source จริง (spec, handoff, README) | /document | orchestrator เบา |
| Review PR .NET บน Azure DevOps | /review-ado-pr | skill งานจริง |
| เขียน Angular ของ SuperApp (shell / remote MF / ui-kit) | /super-front-end | skill งานจริง |
| เช็คว่า step ใน runbook infra agent รันเองได้ไหม | /agent-executable | skill งานจริง |
เลือกไม่ถูกระหว่าง /coding กับ /dev-team? ใช้เกณฑ์เดียว: งานนี้ต้องมี หลักฐานที่ตรวจย้อนหลังได้ ไหม (run directory, evidence matrix, independent review) — ต้อง → dev-team · ไม่ต้อง → coding
3. Plugin ที่ติดตั้ง — สถานะจริงตอนนี้
| Plugin | Version | สถานะ | มีอะไร |
|---|---|---|---|
dev-team | 5.18.0 | 🟢 เปิด | 26 agents + 4 team skills |
specialists | 1.3.1 | 🟢 เปิด | 17 skills (ไม่มี agent ของตัวเอง) |
coding | 1.5.2 | 🟢 เปิด | 4 agents + 1 skill |
design | 1.2.2 | 🟢 เปิด | 3 agents + 1 skill |
document | 1.3.2 | 🟢 เปิด | 3 agents + 1 skill |
review-ado-pr | 1.0.1 | 🟢 เปิด | 1 skill |
super-front-end | 1.0.2 | 🟢 เปิด | 1 skill |
agent-executable | 1.0.1 | 🟢 เปิด | 1 skill |
trading | 1.3.1 | 🔴 ปิด | 4 agents + 1 skill |
news | 1.2.1 | 🔴 ปิด | 3 agents + 1 skill |
ai-learning | 1.3.1 | 🔴 ปิด | 3 agents + 1 skill |
รวมที่ใช้งานได้จริง: 27 skills · 36 agents
3 ตัวที่ปิดอยู่ — มีอะไรบ้าง
ปิดไว้ใน ~/.claude/settings.json (enabledPlugins: false) เพราะไม่ได้ใช้แล้ว — เปิดกลับได้ทุกเมื่อ แต่ instruction ยังเป็นภาษาไทยอยู่ (ยังไม่ผ่านรอบแปลเป็น EN)
| Plugin | Skill | Agents | ทำอะไร |
|---|---|---|---|
trading | /trading | market-scout · news-scout · analyst · skeptic | วิเคราะห์ตลาด crypto/equity/forex — scout ขนาน → thesis → skeptic gate บังคับ |
news | /news | source-hunter · researcher · verifier | research ข่าว ทุก claim ต้องมี citation + cross-check ≥ 2 sources |
ai-learning | /ai-learning | paper-scout · paper-reader · distiller | ตาม paper/model release แล้วกลั่นเป็น knowledge base ส่วนตัว |
4. กติกาที่ใช้ร่วมกันทุกตัว
กฎ 6 ข้อนี้ฝังอยู่ในทุก plugin ไม่ต้องสั่งซ้ำ
- Output ถึง Owner เป็นภาษาไทยเสมอ — ศัพท์เทคนิคคงภาษาอังกฤษ ส่วน instruction ภายใน/คำสั่งที่ส่งให้ worker เป็นภาษาอังกฤษ (ประหยัด token)
- Evidence ก่อน claim — ห้ามบอกว่าเสร็จ/ผ่าน โดยไม่มี exit code จริงจากคำสั่งจริง สรุปของ orchestrator ไม่นับเป็นหลักฐาน
- Output discipline — ทุก call ที่ spawn ต้องระบุ format + ความยาวสูงสุด และสั่งให้ตอบเป็น raw facts ไม่เอา narrative
- Session override — Owner สั่ง model/effort เองได้เสมอ; ขึ้น ได้ทันที, ลง ต่ำกว่า policy ต้องมี override ที่บันทึกเหตุผล + timestamp
- ห้ามเดา — ไม่มี default .NET/Angular/path/URL ติดมากับ agent; ข้อมูลที่ขาดต้องถาม ไม่ใช่สมมติ
- ห้าม publish ออกนอกเครื่องโดยไม่ได้สั่ง — Confluence, Jira, email, PR comment ต้องมีคำสั่งชัดเจนก่อนเสมอ
5. Model กับ effort — อ่านตรงนี้ก่อนตีความ frontmatter ผิด
model: ที่เขียนอยู่ใน agent frontmatter ไม่ใช่ model ที่วิ่งจริงเสมอไป
| กลุ่ม | ตัวจริงที่ dispatch |
|---|---|
| 10 judgment roles ของ dev-team (reviewer, evaluator, skeptic, advisor ต่างๆ) | ตาม model_by_risk → risk low/medium = sonnet, high = opus · frontmatter opus เป็นแค่ เพดาน fail-safe |
counsel | opus เสมอ effort max และ dispatch ที่ max(opus, session model) — ได้รับการยกเว้นจากการลด cost ทุกกรณี |
| specialists ทั้ง 16 ตัว (ยกเว้น counsel) | ตาม session model ที่เปิดอยู่ ถ้าระบุไม่ได้ → ถอยไปใช้ frontmatter (ขึ้นเท่านั้น ไม่ลง) |
| agents ของ coding / design / document | ตาม frontmatter ของตัวเอง — ไม่มี risk-keyed dispatch |
Escalation ขาขึ้นอัตโนมัติ (medium risk เท่านั้น): gate ที่วิ่งด้วย sonnet แล้วรายงาน confidence: low หรือ escalation_requested: true จะถูก รันซ้ำ 1 ครั้งที่ opus/xhigh — trigger เป็น field ในผลลัพธ์เท่านั้น ห้ามอนุมานจากข้อความ · high risk ข้ามกลไกนี้ ใช้ opus ตรงๆ
รายละเอียดครบทุก role อยู่ที่ ตารางอ้างอิง agent ทุกตัว