คุณภาพของโค้ดที่สร้างโดย AI ขึ้นอยู่กับสิ่งที่คุณขอและวิธีที่คุณขอเกือบทั้งหมด คู่มือนี้ครอบคลุมรูปแบบที่สร้างผลลัพธ์ที่ดีกว่ากับ Claude Code อย่างสม่ำเสมอ
ตั้งแต่การกำหนดขอบเขตงานไปจนถึงคำสั่งระบบ ตั้งแต่การปรับปรุงอย่างต่อเนื่องไปจนถึงคำแนะนำเฉพาะบทบาท เทคนิคที่ใช้ได้จริงที่คุณสามารถนำไปใช้ในเซสชันการเขียนโค้ดครั้งถัดไป
เมื่อคุณขอให้ผู้พัฒนามนุษย์ 'สร้างหน้าเข้าสู่ระบบ' พวกเขาจะถามคำถามเพื่อชี้แจง: ผู้ให้บริการการตรวจสอบสิทธิ์ไหน? ฟิลด์ไหน? ควรจัดการ OAuth หรือไม่? ข้อความแสดงข้อผิดพลาด? สถานะการโหลด?
AI coding agents จะพยายามตอบคำถามทั้งหมดด้วยตัวเอง บางครั้งพวกเขาก็เดาถูก บ่อยครั้งพวกเขาก็เดาสิ่งที่สมเหตุสมผลแต่ไม่ใช่สิ่งที่คุณต้องการ ช่องว่างระหว่าง 'สมเหตุสมผล' และ 'ถูกต้องอย่างแน่นอน' คือสิ่งที่การออกแบบคำสั่งช่วยปิด
คำสั่งที่ดีไม่จำเป็นต้องยาว พวกเขาต้องเฉพาะเจาะจงเกี่ยวกับสิ่งที่สำคัญและเงียบเกี่ยวกับสิ่งที่ไม่สำคัญ สมดุลนั้นคือสิ่งที่คู่มือนี้เกี่ยวกับ
รูปแบบที่ปรับปรุงผลลัพธ์ไม่ว่าจะเป็นงานใด
แทนที่จะ 'สร้างคอมโพเนนต์ React, จากนั้นเพิ่มสถานะ, จากนั้นเพิ่มการจัดรูปแบบ' ให้บรรยายผลลัพธ์สุดท้าย: 'สร้างแถบด้านข้างที่พับได้ซึ่งแสดงชื่อโครงการ รองรับการลากเพื่อจัดเรียงใหม่ และใช้ธีม Tailwind ที่มีอยู่ของเรา' ให้ตัวแทนตัดสินใจว่าจะไปถึงที่นั่นได้อย่างไร
Avoid
สร้างคอมโพเนนต์ เพิ่ม useState เพิ่มปุ่มสลับ จัดรูปแบบด้วย Tailwind
Better
สร้างคอมโพเนนต์แถบด้านข้างที่พับได้ซึ่งแสดงรายการโครงการตามชื่อ ควรสนับสนุนการลากเพื่อจัดเรียงใหม่และตรงกับธีมมืดของเรา (bg-[#111318], border-[#262b38]) สถานะที่พับได้ควรคงอยู่ข้ามการโหลดหน้าใหม่
Agents ทำงานได้ดีที่สุดเมื่อพวกเขารู้ขอบเขต กำหนดว่าไฟล์ใดที่จะสัมผัส (หรือละเว้น), รูปแบบใดที่จะปฏิบัติตาม, และ 'เสร็จสิ้น' ดูเป็นอย่างไร งานที่ไม่มีขอบเขตนำไปสู่การเปลี่ยนแปลงที่กระจัดกระจายซึ่งยากต่อการตรวจสอบ
Avoid
ปรับปรุงระบบการตรวจสอบสิทธิ์
Better
ปรับปรุงตัวจัดการการเข้าสู่ระบบใน src/api/auth/login.ts เพื่อใช้ bcrypt แทน sha256 สำหรับการแฮชรหัสผ่าน อย่าเปลี่ยนตรรกะ JWT หรือการจัดการคุกกี้เซสชัน อัปเดตการทดสอบที่เกี่ยวข้องใน tests/auth/
Claude Code สามารถอ่านไฟล์โปรเจกต์ของคุณได้ แต่ไม่สามารถอ่านใจคุณได้ หากมีข้อตกลงที่คุณปฏิบัติตาม ไลบรารีที่คุณชอบ หรือรูปแบบที่คุณได้ตั้งไว้แล้ว ให้บอกด้วย สิ่งนี้ช่วยประหยัดการทำงานซ้ำ
Avoid
เพิ่มการตรวจสอบฟอร์ม
Better
เพิ่มการตรวจสอบฟอร์มในฟอร์มสมัครสมาชิกโดยใช้ zod (เราใช้มันสำหรับฟอร์มการตั้งค่าใน src/forms/settings.ts) แสดงข้อความแสดงข้อผิดพลาดแบบอินไลน์ด้านล่างแต่ละฟิลด์ ปฏิบัติตามการจัดรูปแบบข้อผิดพลาดเดียวกันกับฟอร์มเข้าสู่ระบบ
คำสั่งที่ซับซ้อน ('สร้าง API, เขียนการทดสอบ, อัปเดตเอกสาร, และปรับใช้') บังคับให้ตัวแทนต้องถือเป้าหมายมากเกินไปในครั้งเดียว แบ่งงานที่ซับซ้อนออกเป็นงานที่มีลำดับและมุ่งเน้น แต่ละงานสร้างจากผลลัพธ์ก่อนหน้า
Avoid
สร้างหน้าโปรไฟล์ผู้ใช้ เขียน API endpoints เพิ่มการทดสอบ อัปเดต README และแก้ไขแถบการนำทางในขณะที่คุณทำอยู่
Better
สร้าง endpoint GET /api/user/profile คืนค่า id, name, email, และ plan fields ใช้ middleware การตรวจสอบสิทธิ์ที่มีอยู่สำหรับการตรวจสอบสิทธิ์
ถ้าผลลัพธ์แรกไม่ถูกต้อง ให้ปรับปรุงคำสั่งแทนที่จะเริ่มใหม่ Claude จะรักษาบริบทการสนทนาทั้งหมด บอกว่ามีอะไรผิด ต้องเปลี่ยนอะไร และต้องเก็บอะไรไว้ การทำซ้ำเร็วกว่าการสร้างใหม่
Avoid
นั่นผิด เริ่มใหม่และสร้างส่วนประกอบใหม่ให้แตกต่างออกไป
Better
เลย์เอาต์ดี แต่จุดตัดมือถือผิด ด้านล่าง 768px ให้จัดเรียงการ์ดในแนวตั้งแทนที่จะใช้กริด เก็บทุกอย่างอื่นไว้ตามเดิม
คำสั่งระบบตั้งค่าพฤติกรรมพื้นฐานสำหรับตัวแทนก่อนที่คุณจะพูดอะไร พวกมันเป็นเครื่องมือที่ถูกใช้งานน้อยที่สุดใน AI coding
คำสั่งระบบบอกตัวแทนว่ามันคือใคร ควรให้ความสำคัญกับอะไร และควรหลีกเลี่ยงอะไร มันใช้กับทุกข้อความในเซสชัน คิดว่ามันเป็นคำอธิบายงานของตัวแทน
AgentsRoom มาพร้อมกับคำสั่งระบบเฉพาะบทบาท 14 คำสั่ง: หนึ่งสำหรับแต่ละประเภทตัวแทน คำสั่งของตัวแทน Frontend บอกให้มันมุ่งเน้นไปที่ส่วนประกอบ การเข้าถึง และการออกแบบที่ตอบสนอง คำสั่งของตัวแทน QA บอกให้มันคิดเกี่ยวกับกรณีขอบและเขียนการทดสอบที่ครอบคลุม คุณสามารถปรับแต่งเหล่านี้หรือเขียนของคุณเองได้
คุณเป็นนักพัฒนาฟรอนต์เอนด์ระดับสูง มุ่งเน้นไปที่ส่วนประกอบ React การจัดสไตล์ CSS/Tailwind การเข้าถึง (WCAG AA) และการออกแบบที่ตอบสนอง ใช้ไลบรารีส่วนประกอบที่มีอยู่ในโครงการก่อนที่จะสร้างส่วนประกอบใหม่ ให้ความสำคัญกับการประกอบมากกว่าการสืบทอด เขียน HTML ที่มีความหมาย อย่าแก้ไขไฟล์แบ็คเอนด์
คำสั่งที่มีประสิทธิภาพที่สุดไม่ได้พิมพ์ลงในแชท มันอยู่ในที่เก็บของคุณ
CLAUDE.md เป็นไฟล์ markdown ที่อยู่ในรากของโครงการของคุณที่ Claude Code อ่านโดยอัตโนมัติ มันประกอบด้วยโครงสร้างโครงการ ข้อตกลง รายละเอียดสแต็ก และแนวทางที่ใช้กับทุกเซสชันของตัวแทนในโครงการ
แทนที่จะพูดซ้ำ 'เราใช้ Tailwind CSS 4, Prisma ORM, และ Next.js 16' ในทุกการสนทนา ให้เขียนมันครั้งเดียวใน CLAUDE.md ทุกตัวแทนสืบทอดบริบทนี้ AgentsRoom รวมถึงตัวแก้ไขในตัวสำหรับ CLAUDE.md เพื่อให้คุณสามารถอัปเดตได้โดยไม่ต้องออกจากแอป
CLAUDE.md ที่เขียนได้ดีมีค่ามากกว่าคำสั่งเฉพาะบุคคลที่ถูกสร้างขึ้นอย่างระมัดระวังหลายสิบคำสั่ง มันสะสม: ทุกเซสชันได้รับประโยชน์จากมัน
หยุดการเขียนคำสั่งเดียวกันซ้ำแล้วซ้ำเล่า เก็บสิ่งที่ใช้ได้ผลและนำกลับมาใช้ใหม่
ถ้าคุณพบว่าตัวเองพิมพ์คำขอประเภทเดียวกันในหลายโครงการ ('เขียนการทดสอบหน่วยสำหรับไฟล์นี้', 'ปรับปรุงให้ใช้รูปแบบ repository', 'เพิ่มการจัดการข้อผิดพลาดในทุกเส้นทาง API') ให้บันทึกเป็นคำสั่งที่นำกลับมาใช้ใหม่ได้
AgentsRoom รวมฟีเจอร์ห้องสมุดคำสั่งที่มีสองระดับ: คำสั่งเฉพาะโครงการสำหรับงานเฉพาะในโครงการ และคำสั่งทั่วโลก (ซิงค์กับคลาวด์) สำหรับรูปแบบที่คุณใช้ทุกที่
ผู้สมัครที่ดีสำหรับคำสั่งในห้องสมุด: เช็คลิสต์การตรวจสอบโค้ด, แม่แบบการเขียนการทดสอบ, สคริปต์การโยกย้าย, คำแนะนำการสร้างส่วนประกอบ, ขั้นตอนการตรวจสอบความปลอดภัย อะไรก็ตามที่คุณจะใส่ในวิกิทีมในฐานะขั้นตอนมาตรฐาน
เขียนการทดสอบหน่วยสำหรับ [ไฟล์]. ใช้ vitest. ครอบคลุมเส้นทางที่ดี กรณีขอบ (ข้อมูลว่าง, null, ประเภทที่ไม่ถูกต้อง) และการจัดการข้อผิดพลาด จำลองการพึ่งพาภายนอก ตั้งเป้าหมายให้มีการครอบคลุมสาขามากกว่า 90%
ตรวจสอบการเปลี่ยนแปลงใน git diff ปัจจุบัน ตรวจสอบ: การนำเข้าไม่ใช้, การจัดการข้อผิดพลาดที่ขาดหายไป, ปัญหาความปลอดภัยของประเภท, สถานการณ์การแข่งที่อาจเกิดขึ้น, และความไม่สอดคล้องในการตั้งชื่อ แนะนำการแก้ไขสำหรับแต่ละปัญหาที่พบ
สร้าง REST endpoint สำหรับ [resource] รวมถึงการตรวจสอบข้อมูลนำเข้าด้วย zod, การตอบสนองข้อผิดพลาดที่เหมาะสม (400, 401, 404, 500), ประเภท TypeScript สำหรับคำขอ/การตอบสนอง, และความคิดเห็น JSDoc ที่อธิบาย endpoint ตามรูปแบบที่มีอยู่ใน src/api/.
เทคนิคสำหรับงานที่ซับซ้อนซึ่งเกินกว่าคำสั่งเดียว
แบ่งงานใหญ่เป็นขั้นตอนที่เรียงลำดับ เริ่มต้นตัวแทนแรกด้วยขั้นตอนที่หนึ่ง รอให้เสร็จสิ้น จากนั้นเริ่มตัวแทนถัดไปด้วยขั้นตอนที่สอง (อ้างอิงผลลัพธ์จากขั้นตอนที่หนึ่ง) แต่ละขั้นตอนจะเล็กลงและมุ่งเน้นมากขึ้น ตัวอย่าง: ตัวแทน 1 ออกแบบโครงสร้างฐานข้อมูล ตัวแทน 2 เขียน API โดยใช้โครงสร้างนั้น ตัวแทน 3 เขียนการทดสอบกับ API
หลังจากตัวแทนหนึ่งเสร็จสิ้น ให้ชี้ไปที่ผลลัพธ์ของมันด้วยตัวแทนที่แตกต่างกัน 'ตรวจสอบการเปลี่ยนแปลงที่ตัวแทนส่วนหน้าเพิ่งทำใน src/components/. ตรวจสอบปัญหาการเข้าถึงและสถานะข้อผิดพลาดที่ขาดหายไป' ตัวแทนใหม่ที่มีบทบาทที่แตกต่างกันจะจับสิ่งที่ตัวแทนเดิมพลาดไป
เริ่มต้นด้วยคำสั่งที่หลวมเพื่อดูว่าตัวแทนเข้าหาปัญหาอย่างไร จากนั้นเพิ่มข้อจำกัดในข้อความติดตาม: 'โครงสร้างดี แต่ใช้ส่วนประกอบเซิร์ฟเวอร์แทนส่วนประกอบไคลเอนต์' 'เก็บ hook ไว้ แต่ลบ useEffect และใช้การเปลี่ยนแปลง React Query แทน' ทุกการวนรอบจะทำให้แคบลงไปยังโซลูชันที่คุณต้องการ
ชี้ตัวแทนไปที่โค้ดที่มีอยู่: 'สร้างหน้าการตั้งค่าตามรูปแบบเดียวกับ src/pages/profile.tsx โครงสร้างเลย์เอาต์เดียวกัน การจัดการฟอร์มเดียวกัน การแสดงข้อผิดพลาดเดียวกัน' สิ่งนี้มักจะมีประสิทธิภาพมากกว่าการอธิบายรูปแบบด้วยคำพูด
รูปแบบที่ผลิตผลลัพธ์ที่แย่ลงอย่างต่อเนื่อง
บอกตัวแทนว่าต้องเขียนฟังก์ชันใด ชื่ออะไร และลำดับการดำเนินการอย่างไร การจัดการแบบละเอียดนี้จะทำให้ตัวแทนไม่สามารถหาวิธีที่ดีกว่าได้ อธิบายผลลัพธ์ ไม่ใช่ขั้นตอนการดำเนินการ
การขอให้ตัวแทน 'ปรับปรุงโค้ดเบส' โดยไม่มีข้อจำกัด โดยไม่มีขอบเขต ตัวแทนอาจรีแฟคเตอร์ไฟล์ที่คุณไม่ต้องการให้แตะต้อง เปลี่ยน API ที่โค้ดอื่นขึ้นอยู่กับ หรือใช้โทเค็นในการปรับปรุงที่มีลำดับความสำคัญต่ำ
ไม่กล่าวถึงว่ารูปแบบ ยูทิลิตี้ หรือส่วนประกอบมีอยู่แล้วในโปรเจกต์ ตัวแทนจะสร้างใหม่ หนึ่งประโยคง่ายๆ 'เรามี useAuth hook ใน src/hooks/' ช่วยประหยัดการทำงานซ้ำได้มาก
การบีบห้าหน้าที่ลงในข้อความเดียว ตัวแทนจะพยายามทำทั้งหมด แต่คุณภาพจะลดลงเมื่อมันต้องจัดการกับเป้าหมายที่แข่งขันกัน แยกออกเป็นคำขอที่เรียงลำดับและมุ่งเน้นแทน
AgentsRoom ให้คุณคำสั่งระบบ, ห้องสมุดคำสั่ง, และการแก้ไข CLAUDE.md ที่สร้างขึ้น. ใช้เวลาน้อยลงในการสร้างคำสั่ง, ใช้เวลามากขึ้นในการสร้าง.
แอปคู่หู: ตรวจสอบตัวแทนของคุณได้ทุกที่
นำของคุณเอง: Claude, Codex, Antigravity CLI, หรือผู้ให้บริการ AI อื่น ๆ
ส่งข้อบกพร่องและคำขอไปยังแบ็คล็อกสาธารณะของคุณโดยตรง
มองเห็น AgentsRoom ในการทำงาน