ใช้งาน Oil UI ใน Cursor, Windsurf และ Coding Agent ใน IDE
นักพัฒนาจำนวนมากออกแบบและขัดเกลาอินเทอร์เฟซภายใน Cursor, Windsurf, Antigravity หรือ Gemini CLI ควบคู่ไปกับโค้ดแอปพลิเคชัน เนื่องจาก Oil UI ใช้รูปแบบ Skill มาตรฐานเปิด คำสั่งเดียวอย่าง npx skills add oil-oil/oil-ui จึงติดตั้งเวิร์กโฟลว์ที่ยึดตามภารกิจเดียวกันให้กับ Agent ใน IDE เหล่านี้: สำรวจแนวทาง พัฒนาสถานะที่ทำงานได้จริงใน Stack ของคุณ และตรวจสอบภาพหน้าจอที่เรนเดอร์จริง
สรุปประเด็นสำคัญ
ตัวติดตั้งเดียวครอบคลุม Coding Agent หลักทั้งหมด
รัน npx skills add oil-oil/oil-ui แล้วเลือก Cursor, Windsurf, Claude Code หรือ Codex
ประเด็นสำคัญ 2
เมื่อปรับปรุงหน้าจอภายในโค้ดเบสเดิม ให้จำกัดขอบเขตแต่ละ Prompt ไว้ที่หน้าเดียวหรือ Flow เดียว พร้อมระบุ Props, Hooks และ Routes ที่ห้ามแก้ไข
ประเด็นสำคัญ 3
สำหรับโมดูล UI แบบแยกส่วน (ตัวอัปโหลด, หน้าชำระเงิน, ตัวปรับแต่งสินค้า) ให้สั่ง Agent ทำสถานะ Idle, Active, Completed และ Error ให้ครบตั้งแต่เริ่ม
ประเด็นสำคัญ 4
ให้ Agent ใน IDE เปิด Dev Server บนเครื่องแล้วตรวจภาพหน้าจอเบราว์เซอร์จริงที่ 1440px และ 390px แทนการดูแค่ Code Diff
การติดตั้ง Oil UI ข้ามทั้ง IDE และ CLI Agent
ไม่ว่าคุณจะทำงานผ่านแถบด้านข้างของ Cursor, Windsurf Cascade, Antigravity หรือ Agent ใน Terminal ตัว Oil UI ก็มอบเวิร์กโฟลว์การออกแบบและเช็กลิสต์การตรวจงานด้วยภาพชุดเดียวกัน
รันตัวติดตั้ง Skill แบบโต้ตอบ
รันคำสั่งใน Root ของโปรเจกต์หรือ Terminal แล้วเลือก Coding Agent ที่คุณใช้งานประจำ
npx skills add oil-oil/oil-uiใช้การติดตั้งระดับโปรเจกต์เพื่อให้มาตรฐานตรงกันทั้งทีม
การเลือกขอบเขตโปรเจกต์จะวาง Skill ไว้ใน Repository ทำให้ IDE Agent ของเพื่อนร่วมทีมทุกคนใช้เกณฑ์เลย์เอาต์และการตรวจงานเดียวกัน
เรียกใช้ Oil UI อย่างชัดเจนใน Prompt
ขึ้นต้น UI Prompt ด้วย "Use Oil UI to design..." หรือ "Use Oil UI to refresh this screen..." เพื่อให้ Agent รันเวิร์กโฟลว์การออกแบบแทนการแก้สไตล์แบบเฉพาะหน้า
4 แนวทางปฏิบัติเมื่อออกแบบภายในโค้ดเบสเดิม
ข้อผิดพลาดที่พบบ่อยที่สุดเวลาใช้ IDE Agent คือการโยนทั้งงานแก้ระบบหลังบ้านและงานออกแบบหน้าตาใหม่ทั้งหมดลงใน Prompt ยาวๆ อันเดียว การแยกส่วนความรับผิดชอบช่วยให้ทั้งโค้ดและเลย์เอาต์สะอาด:
- จำกัดขอบเขตทีละ 1 โมดูลหรือ 1 Task Flow ที่จบในตัว
- ขัดเกลาโมดูลเดียวให้สมบูรณ์ตั้งแต่ต้นจนจบ — เช่น โมดูลอัปโหลดไฟล์ Chute หรือตัวปรับแต่งคีย์บอร์ดแมคคานิคอล KEEB ในแกลเลอรี — ก่อนขยับไปหน้าจอถัดไป
- ระบุ Data Hook และ Handler ที่ห้ามแตะต้อง
- เมื่ออัปเดตหน้า React หรือ Vue ที่ใช้งานจริง ให้บอก Agent ว่า: "Keep existing form state, API mutations and route params intact; only rework the layout, hierarchy and state feedback."
- เปรียบเทียบแนวทางใหม่บน Route ชั่วคราวก่อนรวมโค้ด
- หากหน้านั้นต้องการทิศทางภาพใหม่ ให้ Agent เรนเดอร์ 3 ตัวเลือกที่ต่างกันแบบเคียงข้างกันก่อน แล้วค่อยยกแนวทางที่เลือกไปใส่ในคอมโพเนนต์หลัก
- ตรวจเช็กบน localhost ทั้งขนาดเดสก์ท็อปและมือถือเสมอ
- ก่อนกดรับการเปลี่ยนแปลง ให้ Agent เปิด Dev Server ที่รันอยู่แล้วแคปภาพหน้าจอขนาด 1440px และ 390px เพื่อจับจุดที่ล้นกรอบ ช่องว่างอึดอัด หรือคอนทราสต์พัง
Prompt ใช้ซ้ำสำหรับขัดเกลาโมดูลใน Cursor และ Windsurf
แท็กไฟล์คอมโพเนนต์เป้าหมายในช่องแชทของ IDE แล้วใช้โครงสร้างนี้เพื่อให้ได้โค้ดที่ครบทุกสถานะ:
ใช้ Oil UI ออกแบบและพัฒนา [ชื่อโมดูล เช่น โมดูลอัปโหลดแชร์ไฟล์ / ตัวปรับแต่งสินค้า] ใน Repository นี้
- ข้อจำกัดของโค้ดเบส: คง [hooks, props และ API types] เดิมไว้โดยไม่เปลี่ยนแปลง
- สถานะที่ต้องมี: พัฒนาให้ครบ 1) สถานะเริ่มต้น (Idle) 2) การตอบสนองขณะลาก/ป้อนข้อมูล (Active) 3) สถานะความคืบหน้าและเสร็จสมบูรณ์ (พร้อมการยืนยันคัดลอก/แชร์) และ 4) สถานะ Error เมื่อข้อมูลไม่ถูกต้องหรือเกินขีดจำกัด
- วินัยด้านภาพ: หลีกเลี่ยงกล่องการ์ดซ้อนในการ์ดและป้ายแคปซูลตกแต่งเหนือหัวข้อ สร้างลำดับชั้นด้วยสเกลตัวอักษร ระยะห่าง และสถานะ Focus ที่ชัดเจน จากนั้นตรวจสอบในเบราว์เซอร์บนเครื่องใช้งานได้ดีเมื่ออ้างอิงไฟล์คอมโพเนนต์ที่มีอยู่แล้วใน Cursor หรือ Windsurf
ตัวอย่างจริงและ Prompt จากแกลเลอรี
ดูคอลเลกชันทั้งหมด →ปลดล็อกการปรับปรุงโปรเจกต์เดิมและการเก็บงานคอมโพเนนต์ด้วย Oil UI Pro
Oil UI Pro เพิ่มเวิร์กโฟลว์เฉพาะสำหรับโค้ดเบสที่มีอยู่แล้ว — ทั้งการวินิจฉัยหน้าเดียวพร้อมคำอธิบายประกอบ ระบบปรับปรุง 3 ระดับ (ปัดฝุ่น / อัปเกรด / รื้อ Flow + DESIGN.md) และการขัดเกลาคอมโพเนนต์เดี่ยวระดับละเอียดยิบ
ดู Oil UI Pro →npx github:oil-oil/oil-cli install oil-ui-proคำถามที่พบบ่อย
ควรเลือกโมเดลตัวไหนใน Cursor หรือ Windsurf เมื่อใช้ Oil UI?
ใช้ Claude Opus หรือโมเดลระดับสูงของ GPT/Codex เมื่อต้องการสำรวจทิศทางภาพใหม่หรือจัดโครงสร้างหน้าซับซ้อน แต่เมื่อได้แนวทางหรือ DESIGN.md แล้ว Claude Sonnet และโมเดลที่เร็วกว่าจะเหมาะมากกับการขยายสถานะให้ครบในหน้าจออื่นๆ
Oil UI ใช้งานร่วมกับ shadcn/ui, Radix หรือ Tailwind ได้ไหม?
ได้ ไลบรารีพื้นฐานเหล่านั้นให้ตัวควบคุมที่รองรับ Accessibility ส่วน Oil UI ดูแลเรื่องการจัดองค์ประกอบหน้า ลำดับชั้นสายตา การสำรวจแนวทาง และการตัดแพตเทิร์นซ้ำซากของ AI จึงเสริมกันได้ลงตัว
จะมั่นใจได้อย่างไรว่า Agent จะไม่ทำ Click Handler หรือ Form Validation เดิมพัง?
ระบุรายชื่อ Handler ที่ต้องคงไว้ใน Prompt และทำตามขั้นตอน Walkthrough ของ Oil UI: กดทดสอบผ่าน Flow หลักจริงๆ และลองส่งฟอร์มที่ข้อมูลไม่ถูกต้องในเบราว์เซอร์ก่อนจบงาน
ทีมสามารถใช้ทั้ง Cursor และ Claude Code / Codex บน Repository เดียวกันได้ไหม?
ได้ เลือก Agent ที่เกี่ยวข้องทั้งหมดระหว่างรัน npx skills add oil-oil/oil-ui หรือ Commit ไฟล์ DESIGN.md กลางไว้ เพื่อให้ทุกเครื่องมืออ่านกติกาการออกแบบชุดเดียวกัน



