ระดับ 8d · บทที่ 3/6

Workflows — ให้ Claude เขียนสคริปต์สั่ง agent เป็นสิบเป็นร้อยตัว

⏱ 35 นาทีลองในClaude ↗

📎 ไฟล์ตัวอย่างสำหรับบทนี้

เป้าหมาย

เข้าใจว่า workflow ต่างจาก subagent อย่างไร สั่งให้ Claude สร้างและรัน workflow ได้ อ่านสคริปต์ที่ได้ออก บันทึกเป็นคำสั่งใช้ซ้ำ และคุมขนาดกับต้นทุน

หลักการ

Workflow คืออะไร

สคริปต์ JavaScript ที่ Claude เขียน แล้วระบบรันเบื้องหลัง สคริปต์สั่ง agent หลายตัวตามลำดับและขนานกัน ผลระหว่างทางเก็บอยู่ในตัวแปรของสคริปต์ ไม่เข้า context ของ Claude — Claude ได้แค่ผลสุดท้าย

Subagents Workflow
ใครคุมลำดับ Claude ตัดสินใจทีละเทิร์น สคริปต์ (ทำซ้ำได้เหมือนเดิมทุกครั้ง)
ขนาด ไม่กี่ตัวต่อเทิร์น สิบถึงร้อยตัว (สูงสุด 1,000 ต่อการรัน)
ผลระหว่างทาง เข้าบทสนทนาหลัก (เป็นสรุป) อยู่ในสคริปต์
ใช้ซ้ำ สั่งใหม่ทุกครั้ง บันทึกเป็น /คำสั่ง ได้

อ่านสคริปต์ให้ออก (ส่วนประกอบหลัก)

export const meta = { name: 'pr-review', description: '...', phases: [{ title: 'Review' }, { title: 'Verify' }] }

const r = await agent('งาน...', { label: 'review:security', phase: 'Review', schema: SCHEMA, effort: 'low' })
const many = await parallel(items.map(x => () => agent(`ทำกับ ${x}`)))        // รันพร้อมกัน รอครบทุกตัว
const flow = await pipeline(ITEMS, item => agent(...), result => agent(...))  // แต่ละ item ไหลผ่านขั้นของตัวเอง ไม่ต้องรอตัวอื่น
phase('Verify'); log('ข้อความแสดงในหน้าความคืบหน้า')
return { ... }   // ผลที่ส่งกลับให้ Claude
  • schema บังคับให้ agent ตอบเป็น JSON ตามรูปแบบ → สคริปต์เอาไปใช้ต่อได้แน่นอน
  • agent() คืน null ถ้าพังแบบกู้ไม่ได้ → สคริปต์ที่ดีต้องรับมือ null เสมอ
  • ห้ามใช้ Date.now(), Math.random() ในสคริปต์ (เพื่อให้ resume ได้ผลเหมือนเดิม)

รูปแบบที่ใช้บ่อยที่สุด: ตรวจ แล้ว "พยายามหักล้าง"

ขั้นแรกหลาย agent หาปัญหาคนละมุม ขั้นที่สอง agent อีกชุดพยายามพิสูจน์ว่าแต่ละข้อ ไม่จริง เหลือเฉพาะข้อที่หักล้างไม่ได้ — ลดผลบวกลวงที่เป็นปัญหาใหญ่ของการให้ AI รีวิวโค้ด (ดู pr-review.js ด้านบน)

ตั้งค่า ⚙️

ตั้งอะไร ที่ไหน ค่าเริ่ม → แนะนำ
เปิดใช้ แพ็กเกจเสียเงิน/API เปิดอยู่แล้ว · Pro เปิดที่ /config แถว "Dynamic workflows" —
ปิด "disableWorkflows": true หรือ CLAUDE_CODE_DISABLE_WORKFLOWS=1 —
agent พร้อมกัน CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS (1–256) 16 → คงไว้
ขนาดที่ Claude ออกแบบ workflowSizeGuideline medium (< 10 agent) → คงไว้ ขยายเมื่อจำเป็น
อนุญาตใน -p/SDK --allowedTools "Workflow" หรือ Workflow(<ชื่อ>) ไม่มีหน้าต่างถาม ต้องอนุญาตเอง
บันทึกใช้ซ้ำ .claude/workflows/<ชื่อ>.js (ทีม) หรือ ~/.claude/workflows/ (ส่วนตัว) → เรียก /<ชื่อ> · แก้แล้วรัน /reload-skills —
เตือนงานใหญ่ ระบบเตือน "Large workflow" เมื่อเกิน 25 agent หรือคาดว่าเกิน 1.5M token อ่านคำเตือนก่อนกดต่อเสมอ

ลองเลย 🧪

ทดลอง A — workflow เล็กที่สุด (headless) ในโปรเจกต์ที่มีหลายโฟลเดอร์

claude -p "use a workflow: for each of the 3 folders [โฟลเดอร์1], [โฟลเดอร์2], [โฟลเดอร์3], run one agent in parallel that lists files and their purpose in one line; then combine into one table. Keep the workflow small (3 agents). Read-only." \
  --permission-mode dontAsk --allowedTools "Workflow" "Read" "Glob" "Grep" \
  --output-format json < /dev/null | jq '{total_cost_usd, num_turns}'

→ ผลที่เราวัดได้: agent 3 ตัวทำงานพร้อมกัน ใช้ราว $0.81 · สคริปต์ที่ Claude เขียนในการทดสอบนั้นคือ list-lessons.js ด้านบน — เปิดอ่านเทียบกับส่วน "อ่านสคริปต์ให้ออก" → แบบ interactive พิมพ์ ultracode: ... หรือ use a workflow to ... แล้วดูความคืบหน้าด้วย /workflows (p หยุดชั่วคราว, x หยุด, r เริ่มใหม่, s บันทึกเป็นคำสั่ง)

ทดลอง B — บันทึก workflow เป็นคำสั่งของทีม

mkdir -p .claude/workflows
cp pr-review.js .claude/workflows/
claude -p "/pr-review main...HEAD" --permission-mode dontAsk \
  --allowedTools "Workflow" "Read" "Glob" "Grep" "Bash(git diff *)" "Bash(git log *)" "Bash(git show *)" \
  --output-format json < /dev/null | jq -r '.result'

→ ผลที่เราได้จริง (repo ทดลองของบท 7d): reviewer 3 มุมทำงานพร้อมกัน แล้วตรวจซ้ำแต่ละข้อ เหลือข้อที่ยืนยัน 1 ข้อ: slugify("สวัสดี") คืนค่าว่าง เพราะตัดอักษรนอก a–z ทิ้ง (ชื่อภาษาไทยหลายชื่อจะได้ slug ซ้ำกัน) ใช้ราว $0.79 · มุม security และ tests ไม่พบปัญหาและไม่แต่งเรื่องขึ้นมา

ทดลอง C — /deep-research (ต้องเปิด web search)

/deep-research เปรียบเทียบวิธีทำ slug สำหรับชื่อภาษาไทยใน JavaScript: transliteration, เก็บอักษรไทยไว้ใน URL, ใช้ ID — ข้อดีข้อเสียและไลบรารีที่ยังดูแลอยู่

→ workflow สำเร็จรูปที่ค้นหลายแหล่งพร้อมกันแล้วสรุปพร้อมอ้างอิง · แพงกว่าการค้นเว็บปกติมาก ใช้เมื่อคำถามคุ้มจริง

ถ้าพัง

อาการ สาเหตุที่พบบ่อย
-p ค้างหรือไม่ได้รัน workflow ไม่ได้ใส่ Workflow ใน --allowedTools
agent ใน workflow ถูกปฏิเสธคำสั่ง allowlist ของ session คุม agent ทุกตัว → อนุญาต Bash(git diff *) ฯลฯ ที่จำเป็น
/pr-review ไม่รู้จัก ไฟล์ไม่ได้อยู่ใน .claude/workflows/ หรือยังไม่ /reload-skills
ผลเป็น null บางตัว agent พังกลางทาง → สคริปต์ต้อง .filter(Boolean) หรือมีค่าแทน

ข้อดี / ข้อเสีย

✅ ข้อดี ❌ ข้อเสีย
ทำซ้ำได้เหมือนเดิม บันทึกเป็นคำสั่งของทีมได้ ต้นทุนตั้งต้นสูงแม้งานเล็ก (~$0.8 ต่อครั้งที่เล็กที่สุดที่เราวัด)
context ของ Claude ไม่บวม เพราะผลระหว่างทางอยู่ในสคริปต์ ต้องอ่านสคริปต์เป็นถึงจะไว้ใจได้ว่าทำอะไร
ขั้นตรวจแบบหักล้างช่วยลดผลบวกลวง งานใหญ่ใช้ token เป็นล้านได้ง่าย ต้องอ่านคำเตือนขนาด

ไม่ควรใช้เมื่อ: งานที่ agent ตัวเดียวทำได้ในไม่กี่นาที, งานที่ต้องให้คนตัดสินใจระหว่างทาง, หรือยังไม่มีเกณฑ์ว่าผลแบบไหนถูก ทางเลือกที่ง่ายกว่า: subagent 2–3 ตัว (บท 6d-08) หรือ loop script (บท 7d-02) สำหรับงานที่ทำทีละข้อ

สังเกตอะไร

  • reviewer ที่สั่งว่า "ถ้าไม่พบให้ส่งว่าง ห้ามหาเรื่อง" + ขั้นหักล้าง ทำให้ได้ผลน้อยแต่จริง ซึ่งมีค่ากว่ารายการยาวที่ต้องมานั่งคัดเอง
  • workflow ที่บันทึกไว้คือ "SOP ที่รันได้" ของทีม แก้ที่ไฟล์เดียวแล้วทุกคนได้ฉบับใหม่

สรุปจำง่าย

Workflow = สคริปต์ที่สั่ง agent จำนวนมากอย่างเป็นระบบ — ใช้เมื่องานแตกเป็นหลายชิ้นตามแบบเดิมและต้องตรวจซ้ำ อ่านสคริปต์ก่อนเชื่อ และวัดต้นทุนทุกครั้ง