surfup

กติกาโปรเจกต์ 12 ข้อสำหรับ Cursor และ Claude Code

กติกาเชิงปฏิบัติ 12 ข้อเกี่ยวกับบริบทของ repository, SEO, ความปลอดภัย และการเปลี่ยนแปลงที่ตรวจสอบได้

ใช้ขั้นตอนเหล่านี้เป็นรายการตรวจสอบสำหรับการทำงาน และปรับให้เหมาะกับหลักฐาน ขอบเขต และข้อจำกัดของโครงการ

บริบทและขอบเขต

  • อ่านคำแนะนำของโปรเจกต์ที่ใช้กับเครื่องมือนี้ หากมี (เช่น .cursor/rules หรือ CLAUDE.md) และตรวจ README กับ manifest เมื่อมีไฟล์เหล่านี้
  • ก่อนแก้ไข ให้สรุปสถาปัตยกรรมปัจจุบันและระบุเฉพาะไฟล์ที่จำเป็นต่อการเปลี่ยนแปลงนี้
  • กำหนดเป้าหมายให้เป็นผลลัพธ์เดียวที่ตรวจสอบได้ อย่าขยายงานโดยไม่มีเหตุผล
  • ก่อนเปลี่ยน API ให้ระบุผู้ใช้ API รูปแบบ request/response และข้อกำหนดด้านความเข้ากันได้

คุณภาพและความปลอดภัย

  • สำหรับข้อมูลที่ผู้ใช้ป้อนแต่ละชนิด ให้ระบุรูปแบบ ความยาว และวิธีตรวจค่าที่ไม่ปลอดภัย
  • ห้ามใส่ความลับในโค้ด log fixture ตัวอย่าง หรือไฟล์ frontend ที่ส่งให้ผู้ใช้
  • สำหรับหน้าค้นหา ให้ตรวจ title, description, canonical, robots, headings, links และ HTML ต้นทาง
  • จัดเตรียมข้อความของแต่ละภาษา ตัวอย่างช่องทางติดต่อที่เหมาะกับภูมิภาค และ URL ที่สอดคล้องกัน
  • ทำให้องค์ประกอบโต้ตอบใช้งานด้วยแป้นพิมพ์ได้ มีชื่อที่เทคโนโลยีช่วยเหลืออ่านได้ และแสดงสถานะโฟกัสชัดเจน

การตรวจสอบและรายงาน

  • เรียกใช้เฉพาะการตรวจที่ยืนยันพฤติกรรมที่เปลี่ยนไป อย่าอ้างว่าเรียกคำสั่งที่ไม่ได้เรียก
  • เทียบผลกับเกณฑ์การยอมรับ ตรวจเส้นทางข้อผิดพลาดและหน้าจอมือถือ
  • รายงานการเปลี่ยนแปลง คำสั่งที่เรียกใช้และผลจริง ข้อจำกัดที่ทราบ และวิธีย้อนกลับ