React Doctor คืออะไร ตรวจโค้ด React ที่ AI เขียนด้วยคำสั่งเดียว
รัน npx react-doctor@latest แล้วได้คะแนน 0–100 พร้อมไฟล์ บรรทัด และวิธีแก้ทุกจุด จากนั้นติดตั้งเป็น Skill ให้ Claude Code, Cursor หรือ Codex ตรวจงานตัวเองก่อนส่ง พร้อมข้อควรระวังเรื่อง telemetry และ license

ใครให้ AI เขียนเว็บ React ทุกวัน คงเคยเจอแบบนี้ครับ หน้าเว็บใช้ได้ ปุ่มกดได้ แต่พอเปิดโค้ดดู มี useEffect ที่ไม่จำเป็นเต็มไปหมด component เรนเดอร์ซ้ำ หรือส่ง props ต่อกันลงไป 5 ชั้น
React Doctor คือตัวตรวจที่ไล่ดูเรื่องพวกนี้ทั้งโปรเจกต์ในคำสั่งเดียว แล้วสรุปเป็นคะแนน 0–100 บทความนี้พารันครั้งแรก อ่านผลให้เป็น แล้วติดตั้งให้ AI ตรวจงานตัวเองก่อนส่งทุกครั้ง
React Doctor คืออะไร
React Doctor เป็น CLI ฟรีจาก Million Software ทีมเดียวกับที่ทำ React Scan และ Million.js สโลแกนของมันตรงมากครับ "Your agent writes bad React. This catches it."
มันสแกนโค้ดแบบ deterministic (โค้ดเดิม รันกี่รอบก็ได้ผลเหมือนเดิม) หาปัญหา 6 กลุ่ม: state กับ effects, performance, architecture, security, accessibility และ maintainability แล้วชี้ด้วยว่า function ไหนซับซ้อนเกินไป หรือ JSX ก้อนไหนเขียนซ้ำจนควรแยกเป็น component
นึกภาพว่ามันคือการตรวจสุขภาพประจำปีของโปรเจกต์ AI ช่วยให้เราสร้างได้เร็ว ส่วนหมอคนนี้บอกว่าตรงไหนต้องรักษาก่อน

ใช้ได้กับ Next.js, Vite, Astro, TanStack, React Native, Expo และ Preact
สิ่งที่ต้องมี
- Node.js ที่มีคำสั่ง
npx(ถ้าพิมพ์แล้วขึ้นcommand not found: npxให้ลง Node ก่อน) - โปรเจกต์ React ของเรา เปิด Terminal ไว้ที่โฟลเดอร์บนสุดของโปรเจกต์
ใช้ยังไง
ขั้นที่ 1 — สแกนครั้งแรก
npx react-doctor@latest
มันจะดูเองว่าเราใช้ framework อะไร React เวอร์ชันไหน แล้วพิมพ์คะแนนสุขภาพกับรายการปัญหาที่เจอออกมา ไม่ต้องตั้งค่าอะไรก่อนเลย

ตอนผมลอง ผมก๊อปโปรเจกต์ไปไว้อีกโฟลเดอร์แล้วรันกับสำเนา ไม่แตะของจริง แนะนำให้ทำแบบนี้ในครั้งแรกเหมือนกันครับ จะได้สบายใจ
ขั้นที่ 2 — ดูว่าผิดตรงไหน
npx react-doctor@latest --verbose
ทุกข้อจะบอกครบ 4 อย่าง: ไฟล์ บรรทัด ชื่อกฎ และวิธีแก้ที่แนะนำ Docs แนะนำให้แก้เรื่อง security กับ performance ก่อน แล้วค่อยไล่ข้ออื่น
ข้อไหนอ่านแล้วไม่เข้าใจ ถามมันตรงๆ ได้ (เปลี่ยน path กับเลขบรรทัดเป็นของเรา)
npx react-doctor@latest why src/App.tsx:42

ถ้าโปรเจกต์ใหญ่แล้วปัญหาเก่าเยอะ อยากดูแค่สิ่งที่ branch นี้เพิ่งเพิ่มเข้ามา ใส่ --scope changed
npx react-doctor@latest --verbose --scope changed
ขั้นที่ 3 — ให้ AI ตรวจเองทุกครั้งที่เขียนเสร็จ
ขั้นนี้คือส่วนที่ผมชอบที่สุดครับ
npx react-doctor@latest install
มันจะหาว่าเครื่องเรามี AI ตัวไหน (Claude Code, Cursor, Codex, OpenCode และอีกหลายตัว) แล้วติดตั้ง Skill /react-doctor ให้ หลังจากนี้ AI จะสแกนโค้ด React ที่มันเพิ่งแก้ก่อนบอกว่างานเสร็จ
อยากดูก่อนว่ามันจะเขียนไฟล์อะไรบ้าง ใส่ --dry-run จะยังไม่มีอะไรถูกเขียนลงเครื่อง
npx react-doctor@latest install --dry-run
ตอนผมรันแบบ dry run มันเจอ Claude Code, Codex กับ Cursor ในเครื่องและเลือกไว้ให้เลย

ใครอยากให้ AI แก้ตัวเองระหว่างทำงานเลย ไม่ต้องรอจบงาน ยังมี native hooks ให้เปิดเพิ่มด้วย --agent-hooks แต่เริ่มจาก Skill เฉยๆ ก่อนก็พอครับ
ขั้นที่ 4 (ลูกเล่น) — ดูว่าส่วนไหนเรนเดอร์ซ้ำ
เปิดเว็บที่รันอยู่ในเครื่องไว้ (เช่น npm run dev) แล้วสั่ง
npx react-doctor@latest scan http://localhost:3000
มันจะเปิด Chrome แบบแยกโปรไฟล์ชั่วคราว แล้วมีกรอบสีม่วงพร้อมชื่อ component กะพริบขึ้นตรงส่วนที่ React กำลังเรนเดอร์ เราคลิกเล่นในเว็บไปเรื่อยๆ พอแล้วกด Enter (อัดได้นานสุด 5 นาที) ส่วนไหนกะพริบบ่อยผิดปกติ ก็คือส่วนที่ควรไปดู
ทำอะไรได้บ้าง
- ก่อนส่งงานลูกค้า — สั่ง AI ว่า "รัน React Doctor แล้วแก้ทุกข้อที่เป็น error ให้หน่อย แก้เสร็จรันซ้ำจนผ่าน"
- ตรวจทุก Pull Request —
npx react-doctor@latest ci installตั้ง CI ให้ตรวจทุก PR และรายงานเฉพาะปัญหาที่ PR นั้นเพิ่มเข้ามา ไม่เอาปัญหาเก่ามาปน - ดูแค่คะแนน —
npx react-doctor@latest --scoreได้ตัวเลขตัวเดียว เอาไว้ดูว่าดีขึ้นหรือแย่ลง
อยากดูมันทำงานจริงก่อนลง มีคลิปเดโมอยู่ใน README บน GitHub และ โพสต์นี้บน X ที่โชว์ v2 ครับ

เกร็ดเล็กๆ: ทีมเดียวกันทำ ReactBench ที่ให้ AI เขียน React แล้วต้องผ่านทั้งเทสต์และ React Doctor ผลล่าสุดโมเดลอันดับ 1 ยังผ่านแค่ 47% ไม่ถึงครึ่ง (เป็น benchmark ของผู้ทำเครื่องมือเอง อ่านเป็นข้อมูลประกอบนะครับ) เป็นเหตุผลดีๆ ว่าทำไมไม่ควรเชื่อโค้ด React ที่ AI เขียนแบบไม่ตรวจ
ข้อควรระวัง
- Telemetry — ค่าเริ่มต้นจะส่งข้อมูลการใช้งานไป Sentry (เวอร์ชัน CLI, framework, ชื่อกฎและจำนวนที่เจอ) ไม่ส่งเนื้อหาไฟล์ ปิดได้ด้วย
--no-telemetry - Score API — คะแนนคำนวณผ่าน score API และสร้างลิงก์แชร์ ถ้าไม่อยากให้มีอะไรออกนอกเครื่อง ใส่
--no-score - License — เป็น "Modified MIT" ใช้ฟรีได้เกือบทุกกรณี แต่ถ้าเอาไปเทรน AI หรือใช้เชิงพาณิชย์ขนาดใหญ่ ต้องขออนุญาตเป็นลายลักษณ์อักษรจาก Million Software
- ไฟล์จาก
scan— trace ที่ได้อาจมี URL ของหน้าเว็บและ path ในเครื่องเรา Docs บอกให้ถือว่าเป็นข้อมูลอ่อนไหว อย่าแชร์ต่อ - คะแนนคือตัวช่วย ไม่ใช่คำตัดสิน — อ่านแต่ละข้อก่อนให้ AI แก้ บางข้ออาจตั้งใจเขียนแบบนั้นอยู่แล้ว
ตัวอย่างคำสั่งแบบปิดทั้งสองอย่าง
npx react-doctor@latest --no-telemetry --no-score
สิ่งที่ได้ / ลองต่อ
- รู้ว่าโค้ดที่ AI เขียนมีปัญหาตรงไหน พร้อมไฟล์ บรรทัด และวิธีแก้
- AI ตรวจงานตัวเองก่อนส่ง ไม่ต้องคอยไล่จับเอง
- ขั้นต่อไป: ลองรันกับโปรเจกต์ล่าสุดของคุณตอนนี้เลย แล้วส่งผลให้ AI แก้ทีละกลุ่ม
อยากใช้ AI เขียนเว็บให้คล่องกว่านี้ ดูคอร์สทั้งหมด ได้เลยครับ
ลิงก์
- เว็บทางการ: react.doctor
- Docs: react.doctor/docs · Quickstart · Install for coding agents · How to fix issues
- GitHub: millionco/react-doctor
- npm: react-doctor
- ReactBench: reactbench.com/blog
- คลิปเดโม v2 บน X: @DivyanshT91162