oh-my-openagent-toolkit - ชุดเครื่องมือปฏิบัติการแบบโลคัลที่เริ่มจาก Claude Code แล้วมาตั้งหลักกับ OpenCode/oh-my-openagent

สวัสดีครับ
ตั้งแต่ช่วงที่ผมใช้งาน Claude Code อย่างจริงจัง ผมรู้สึกว่าพอเอา AI coding agent มาใช้งานกับโปรเจกต์จริง สุดท้ายสิ่งที่จำเป็นไม่แพ้ตัวโค้ดเองก็คือเลเยอร์ที่อธิบายว่า “ในโปรเจกต์นี้ควรทำงานอย่างไร”

ตัวอย่างเช่นเรื่องพวกนี้:

• คำขอแบบไหนควรถูก route ไปที่ไหน
• ควรติด built-in helper ตัวไหน
• ขอบเขตการรองรับที่ตอนนี้สามารถพูดได้อย่างมั่นใจจริง ๆ มีถึงแค่ไหน
• งานใหม่ควรถูกสร้างไว้ที่ไหน และควรจัดการกับโปรเจกต์เดิมอย่างไร
• งาน refinement ฝั่ง UI ควรถูกวางเพิ่มจากตรงไหนและอย่างไร

ช่วงแรกผมค่อย ๆ ปรับแต่งฝั่ง Claude Code ตามวิธีของตัวเอง จากนั้นก็ลองย้ายไปฝั่ง OpenCode อยู่พักหนึ่ง และตอนนี้มาลงตัวบน oh-my-openagent โดยรวมมันให้อยู่ในรูปแบบที่ใช้กับโปรเจกต์แบบโลคัลได้อย่างสม่ำเสมอมากขึ้น
ครั้งนี้ผมเลยเปิดเผยสิ่งนี้ในชื่อ oh-my-openagent-toolkit

GitHub:
https://github.com/HanTechnology/oh-my-openagent-toolkit

มันคืออะไร?

ถ้าจะอธิบายสั้น ๆ ในหนึ่งบรรทัด
มันคือ project-local companion toolkit ที่ใช้บน OpenCode + oh-my-openagent

ถ้าพูดให้ชัดขึ้นอีกหน่อย
มันไม่ได้มีไว้เพื่อแทนที่ upstream harness แต่ใกล้เคียงกับการวางซ้อนอยู่ด้านบนเพื่อทำให้เลเยอร์ปฏิบัติการแบบโลคัลชัดเจนขึ้น
สิ่งที่รีโปนี้เพิ่มเข้ามาหลัก ๆ มีประมาณนี้

• thin routing
  • จัดระเบียบว่าคำขอควรถูกส่งไปที่ไหน
  • ชี้แนะให้ชัดขึ้นว่าควรใช้ category / helper แบบไหน
• skill surface
  • จัด top-level entrypoint ไว้ใต้ .opencode/skills/
  • ตอนนี้มี 43 entrypoint โดยในนั้น 40 ตัวเป็น core surface และอีก 3 ตัวเป็น planned adjacent pack
• support boundary
  • แยก validated / guided / planned ออกจากกัน
  • เพื่อแยกระหว่าง “น่าจะทำได้” กับ “สิ่งที่ตอนนี้สามารถประกาศต่อสาธารณะได้อย่างมั่นใจ”
• workspace convention
  • จัดแนวทางว่าจะอ่านจาก repo root อย่างไร และจะยึดตรงไหนเป็นฐานในการทำงาน
• UI refinement layer
  • รวมสาย impeccable ไว้แบบโลคัล
  • เพื่อให้ตอนทำงาน UI สามารถวาง refinement layer เพิ่มบน primary route ได้

ทำไมถึงสร้างมันขึ้นมา?

พอเอา AI coding agent ไปผูกกับโปรเจกต์จริง จะมีจุดหนึ่งที่สิ่งสำคัญกว่า “agent ฉลาดแค่ไหน” คือ “ภายในโปรเจกต์นี้ agent ควรเคลื่อนที่ตามกฎอะไร”

โดยเฉพาะเมื่อมีหลายโดเมนปะปนกันก็ยิ่งชัด

• frontend / backend / systems / data / security / QA
• ขอบเขตระหว่างการลงมือทำกับการตรวจสอบความถูกต้อง
• การแยกเอกสารออกจาก validated surface ที่ใช้งานจริง
• ควรติด agent helper เมื่อไร และไม่ควรติดเมื่อไร

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

สิ่งนี้ไม่ใช่สามอย่างต่อไปนี้

• (X) ชุดเผยแพร่ upstream อย่างเป็นทางการของ oh-my-openagent
• (X) runtime ใหม่ที่มาแทน harness
• (X) control plane อีกตัวหนึ่งในเครื่องโลคัล

สรุปคือมันเป็น companion toolkit ที่วางอยู่บน upstream
ไม่ใช่แนวทางที่จะสร้างเฟรมเวิร์กใหม่เพิ่มขึ้นมาอีกตัว

ตอนนี้ทำได้ถึงไหนแล้ว?

ตรงนี้ผมก็พยายามไม่จำกัดมันมากเกินไปเหมือนกัน
ตอนนี้รีโปนี้มี broad skill surface (สกิล 43 แบบที่ครอบคลุมงานพัฒนาโดยรวม)
แต่สิ่งที่จัดไว้เป็น validated ในตอนนี้มีอยู่ 4 ตัวดังนี้

• frontend-product-delivery
• backend-service-delivery
• cloud-release-readiness
• ai-data-product-delivery

ที่เหลือถูกจัดไว้เป็น guided หรือ planned

เหมาะกับใครบ้าง?

มันอาจเหมาะกับคนแบบนี้

• คนที่ใช้งาน OpenCode อยู่แล้ว หรือกำลังจะลองใช้
• คนที่อยากทำให้เลเยอร์ปฏิบัติการของโปรเจกต์แบบโลคัลบน oh-my-openagent ชัดเจนขึ้น
• คนที่รัน AI coding agent กับ repo/worktree จริง และอยากจัดระเบียบเรื่อง
  routing / support boundary / workspace rule
• คนที่อยากทิ้งความรู้เชิงปฏิบัติการไว้ในโปรเจกต์ แทนการเขียนพรอมป์ยาว ๆ อย่างเดียว

ลองใช้อย่างรวดเร็ว

รีโปนี้ใช้งานคร่าว ๆ ตามลำดับนี้ได้เลย

1. ติดตั้ง OpenCode
2. ตั้งค่า oh-my-openagent
3. clone รีโป
4. รัน opencode
5. ทำ vibe coding ด้วยชุด Sisyphus หรือการจับคู่ Prometheus + Atlas ของ oh-my-openagent

สุดท้ายนี้

มันยังไม่ถึงขั้นเป็นของที่สมบูรณ์แบบ
แต่ใกล้เคียงกับชุดเครื่องมือปฏิบัติการแบบโลคัลที่ผมรวบรวมขึ้นมาเพราะจำเป็นต้องใช้จริง ระหว่างย้ายจาก Claude Code → OpenCode → oh-my-openagent

ถ้าใครเคยมีโจทย์คล้าย ๆ กัน ฝากช่วยให้ฟีดแบ็กด้วยครับ

Repo:

https://github.com/HanTechnology/oh-my-openagent-toolkit