Oil UI
Playbook ตามสถานการณ์ · ปรับปรุงโปรเจกต์เดิม

การปรับปรุง UI โปรเจกต์เดิม: รีเฟรชแอป React และเว็บแอปอย่างปลอดภัย

การสร้างเดโมโปรเจกต์ใหม่จากศูนย์นั้นง่าย แต่การปรับโฉมแอปที่รันบนโปรดักชันจริงโดยไม่ทำให้ API Contract, การตรวจสอบฟอร์ม หรือ URL State พัง คือจุดที่ AI Prompt แบบสั่งครั้งเดียวมักพังไม่เป็นท่า ทางที่ปลอดภัยคือการล็อก Business Logic ที่ห้ามแตะไว้ก่อน ทำตามขอบเขตการปรับปรุงทีละขั้น ทดลองเดินตาม Task จริงด้วยการนับจำนวนคลิก และสกัด DESIGN.md กลางจากหน้าจอแรกที่ทำเสร็จสมบูรณ์

สรุปประเด็นสำคัญ

ล็อกกติกาธุรกิจไว้ก่อนเป็นอันดับแรก

ระบุ Payload ของ API, Route Params และ Form Handler ที่ Agent ห้ามแตะต้อง

ปรับปรุงใน 3 ขั้นตอนชัดเจน

ขั้นที่ 1 ตัดเสียงรบกวนจากเส้นขอบและสี, ขั้นที่ 2 ยกระดับเลย์เอาต์และเก็บสถานะที่ขาด, ขั้นที่ 3 ยุบห่วงโซ่ Modal ที่ข้ามหลายหน้า

ประเด็นสำคัญ 3

ยืนยันความใช้ง่ายด้วยการนับจำนวนคลิก — การลดลูปหน้าแก้ไขรายละเอียดจาก 8 คลิกเหลือ Batch Action ในหน้าเดียว 2 คลิก ดีกว่าการเปลี่ยนสีผิวหน้าต่างอย่างเดียว

ประเด็นสำคัญ 4

เมื่อหน้าจอหลักผ่านการตรวจสอบแล้ว ให้บันทึก Token, สเกลตัวอักษร และระยะห่างลงใน DESIGN.md เพื่อให้ Route ข้างเคียงทั้งหมดตรงกัน

จำนวนคลิกจนจบงาน
2ขั้น
การเปลี่ยนหน้า
0หน้า
ความเสี่ยงต้องย้อนกลับ
ไม่เปลี่ยนหน้า · ดูตัวอย่างคู่กัน + ทำเป็นชุดและเลิกทำใน 1 คลิก
Branch · สมุดติดต่อลูกค้า
คิวยังไม่ตอบกลับ (3)
06 ต.ค.
08 ต.ค.
09 ต.ค.
เลือก 2 ราย
บริบทข้อความ

Zhou Yu · ร้านหนังสือเสี่ยวหม่าน

งานสัปดาห์หนังสือฤดูใบไม้ร่วงและบัตรสมาชิก

ส่งล่าสุด
06 ต.ค. · ส่งร่างข้อเสนอแล้ว
สถานะ
รอการตอบกลับจากลูกค้า
“ร่างแบบงานสัปดาห์หนังสือฤดูใบไม้ร่วงและบัตรสมาชิกพร้อมให้ตรวจแล้ว หากยืนยันได้ภายในสัปดาห์นี้ เราจะเดินหน้าขั้นถัดไปได้ตามกำหนด”
ติดตั้ง Oil UI Pro เพื่อใช้เวิร์กโฟลว์วินิจฉัยและปรับปรุง 3 ขั้นตอนฉบับเต็ม
npx github:oil-oil/oil-cli install oil-ui-pro

หากต้องการลองบอร์ดทิศทางพื้นฐานและการลดสิ่งรกตาบนหน้าจอเดียวก่อน ให้รัน npx skills add oil-oil/oil-ui เพื่อใช้ Skill ฟรี

3 ขั้นตอนของการปรับปรุง UI: เลือกระดับผลกระทบให้เหมาะกับงาน

หลายทีมมักลังเลที่จะให้ Coding Agent แตะหน้าโปรดักชัน เพราะ Prompt กว้างๆ อย่าง "make this page look nicer" อาจไปรื้อ Props ของคอมโพเนนต์หรือเผลอลบตัวกรองที่ใช้งานอยู่ได้ ใน Oil UI (และโดยเฉพาะเวิร์กโฟลว์โปรเจกต์เดิมใน Oil UI Pro) การปรับปรุงจะแบ่งออกเป็น 3 ขั้นตอนชัดเจน:

การปรับปรุงโปรเจกต์เดิม 3 ขั้นตอนใน Oil UI
ขั้นตอนควรใช้เมื่อใดสิ่งที่เปลี่ยนแปลงสิ่งที่คงไว้เหมือนเดิม
ขั้นที่ 1: ปัดฝุ่นลดสิ่งรกตาFlow ใช้งานได้ดีอยู่แล้ว แต่เส้นขอบ ขนาดตัวอักษร ระยะห่าง และสีดูรกหรือล้าสมัยสเกลตัวอักษร การตัดเส้นขอบ การจัดแนว การคุมสี และการทำความสะอาดการ์ดโครงสร้าง DOM, Routes, State Hooks และ Interaction Flow ทั้งหมด
ขั้นที่ 2: ยกระดับเลย์เอาต์และสถานะลำดับชั้นทางสายตาแบนราบ ปุ่มสำคัญจมหาย หรือขาดสถานะ Loading/Empty/Errorลำดับชั้น Section, สัดส่วนหลายคอลัมน์, Responsive Breakpoints และสถานะ UI ที่ครบถ้วนสัญญาเชื่อมต่อ Backend API, Business Logic และการนำทางข้ามหน้า
ขั้นที่ 3: รื้อ Flow ที่ติดขัดและสกัด DESIGN.mdผู้ใช้ต้องคลิกผ่าน Modal ซ้อนกันหรือหน้าจอที่กระจัดกระจายเพื่อทำงานพื้นฐานการรวมขั้นตอน การแก้ไขแบบ Inline การออกแบบหน้าจอหลักใหม่ และ DESIGN.md ระดับ RepositoryDomain Model พื้นฐานและกฎความถูกต้องของข้อมูล

4 ขั้นตอนในการปรับปรุงแอปที่รันอยู่จริงอย่างปลอดภัย

ไม่ว่าคุณจะรีเฟรชแอปตรวจสัญญา (อย่าง MOQI ในแกลเลอรี) ตัวติดตาม Sprint (Relay) ไคลเอนต์อีเมล (Post) หรือ Flow ชำระเงิน (Pinch Checkout) ให้ทำตามลำดับที่ควบคุมได้:

  1. แคปภาพหน้าจอปัจจุบันแล้วทำบันทึกวินิจฉัยแบบชี้จุด

    ให้ Agent แคปภาพหน้าเว็บที่รันอยู่จริงก่อน แล้วลิสต์จุดบกพร่องด้านภาพและการโต้ตอบแบบมีหมายเลขกำกับ (เช่น ปุ่มสีหลัก 3 ปุ่มแย่งความเด่นกันบน Header, ตาราง 12 คอลัมน์ถูกตัดขอบที่ 1280px หรือใช้ Alert Box ดิบๆ เมื่อเกิด Error)

  2. ปรับปรุงหน้าจอหลักเพียง 1 หน้าก่อน

    อย่าเพิ่งแก้ทีเดียว 20 Route เลือกหน้าจอเดียวที่ผู้ใช้ใช้เวลามากที่สุด เทียบแนวทางปรับโฉม 2–3 แบบด้วยข้อมูลจริง แล้วล็อกผู้ชนะไว้

  3. เดินทดสอบ Task ของผู้ใช้ให้ครบและนับจำนวนคลิก

    คลิกและพิมพ์ผ่าน Flow จริงในเบราว์เซอร์ — กรองข้อมูล ส่งฟอร์ม กระตุ้น Validation Error แล้วกู้คืน ยืนยันว่าภารกิจที่ใช้บ่อยใช้จำนวนขั้นลดลงกว่าเดิม

  4. สกัด DESIGN.md แล้วขยายผลไปยังหน้าข้างเคียง

    เมื่อหน้าจอหลักผ่าน Visual Review แล้ว ให้ Agent เขียนชุดสีพื้นผิว สเกลตัวอักษร ความหนาแน่นตาราง และกฎตัดแพตเทิร์นซ้ำซากลงใน DESIGN.md จากนั้นนำสเปกนั้นไปใช้กับส่วนที่เหลือของแอป

เทมเพลต Prompt สำหรับปรับปรุงหน้าจอที่มีอยู่แล้ว

ใช้โครงสร้างนี้ใน Claude Code, Codex หรือ Cursor เพื่อยกระดับหน้าจอที่ใช้งานอยู่จริงพร้อมปกป้อง Application Logic:

เทมเพลต Prompt ปรับปรุง UI โปรเจกต์เดิม
ใช้ Oil UI ปรับปรุง [พาธ Route หรือคอมโพเนนต์ เช่น app/billing/page.tsx] ในโปรเจกต์นี้
- พฤติกรรมที่ต้องรักษาไว้อย่างเคร่งครัด: คง [data queries, URL filter params, กฎการตรวจสอบฟอร์ม และ submit/export handlers] เดิมทั้งหมดไว้ ห้ามลบฟิลด์ธุรกิจใดๆ ออก
- ปัญหาปัจจุบันที่ต้องแก้: [เช่น ทุก Section หน้าตาเหมือนการ์ดมีขอบแบบเดียวกันหมด คอลัมน์ตารางตัดบรรทัดเกะกะ และขาดสถานะเมื่อกรองไม่พบข้อมูลหรือจ่ายเงินล้มเหลว]
- ขั้นตอนการปรับปรุง: [เลือก: ขั้นที่ 1 ปัดฝุ่นลดสิ่งรกตา / ขั้นที่ 2 ยกระดับเลย์เอาต์และสถานะ / ขั้นที่ 3 รื้อ Flow และสกัด DESIGN.md]
เริ่มจากการแคปภาพและวินิจฉัยหน้าจอจริงปัจจุบัน เสนอแนวทาง และตรวจสอบหน้าเว็บที่เสร็จแล้วที่ 1440×900 และ 390×844

การระบุพฤติกรรมที่ต้องรักษาไว้ในข้อแรกสุดช่วยป้องกันการพังย้อนหลังโดยไม่ตั้งใจ

ตัวอย่างจริงและ Prompt จากแกลเลอรี

ดูคอลเลกชันทั้งหมด →
Oil UI Pro

ปรับปรุงแอปบนโปรดักชันอย่างปลอดภัยด้วย Oil UI Pro

Prompt ออกแบบใหม่ที่คลุมเครือมักทำตัวกรองและ Form Handler ที่ทำงานอยู่พัง Oil UI Pro วินิจฉัยหน้าจอจริงของคุณจากภาพหน้าจอก่อน ปรับปรุงใน 3 ขั้นตอนที่ควบคุมได้ นับจำนวนคลิกตลอด Task จริง และสกัด DESIGN.md ระดับ Repository (ซื้อครั้งเดียว $19.99)

ดู Oil UI Pro →
คัดลอก Prompt ติดตั้ง Pro
npx github:oil-oil/oil-cli install oil-ui-pro

คำถามที่พบบ่อย

ควรกำหนด Global CSS Tokens ก่อน หรือปรับปรุงหน้าจอจริงสัก 1 หน้าก่อน?

ปรับปรุงหน้าจอตัวแทน 1 หน้าก่อน ไฟล์ Token เชิงนามธรรมที่เขียนขึ้นมาลอยๆ มักไปไม่รอดเมื่อเจอความหนาแน่นของตารางและสถานะฟอร์มจริง การขัดเกลาหน้าจอหลัก 1 หน้าด้วยข้อมูลจริงจะทำให้การสกัด Token ที่แม่นยำลงใน DESIGN.md ทำได้ตรงไปตรงมา

สามารถทยอยปรับปรุงแอปเก่าทีละส่วนโดยไม่เขียนวิดเจ็ตของ Third-party ใหม่ได้ไหม?

ได้ การทำขั้นที่ 1 หรือขั้นที่ 2 สามารถจัดกริดหน้าเว็บ ตัวอักษร ระยะห่าง และสถานะรอบข้างใหม่ได้ โดยปล่อยวิดเจ็ตที่ฝังอยู่ซับซ้อนไว้ตามเดิมจนกว่าคุณจะพร้อมเปลี่ยน

จะตรวจสอบได้อย่างไรว่าการออกแบบใหม่ช่วยให้ใช้งานง่ายขึ้นจริง?

เช็ก 2 อย่าง: หนึ่ง เบลอข้อความเพื่อยืนยันว่าการกระทำหลักและสถานะข้อยกเว้นโดดเด่นขึ้นตามโครงสร้าง; สอง ทำ Task หลักของผู้ใช้ในเบราว์เซอร์ให้จบและตรวจว่าจำนวนคลิก การเลื่อนหา และเวลาแก้ไข Error ลดลงกว่าเดิม

เมื่อสกัด DESIGN.md ออกมาแล้ว ควรเก็บไว้ที่ไหน?

เก็บ DESIGN.md ไว้ที่ Root ของ Repository หรือโฟลเดอร์ docs/ ทุกครั้งที่คุณหรือเพื่อนร่วมทีมสร้างฟีเจอร์ใหม่ใน Claude Code, Codex หรือ Cursor ให้ชี้ Agent มาที่ DESIGN.md เพื่อคุมให้หน้าจอใหม่เข้ากับระบบเดิม

คู่มือที่เกี่ยวข้อง

คู่มือ UI สำหรับ Cursor และ Windsurf ↗วิธีแก้ UI สำเร็จรูปสไตล์ AI Slop ↗Blind Review บนหน้าจอจริง ↗