ทักษะการ Onboarding โปรเจกต์
ช่วย developer ใหม่เข้าใจโปรเจกต์นี้ ตั้งแต่ clone ไปจนรัน local ได้ โดยต้องอ้างอิงจากไฟล์จริงใน repo ก่อนตอบ
ข้อควรระวัง (Gotchas)
- ห้ามเดา script ที่ไม่มีใน
package.json - ห้ามใช้คำสั่ง database destructive ระหว่าง onboarding เช่น
npx prisma db push,npx prisma migrate deploy,npx prisma migrate dev - ถ้าพูดถึง Docker ต้องตรวจทั้ง
Dockerfileและnext.config.ts
ขั้นตอนการตั้งค่า
ให้ตรวจและรัน script นี้ก่อน .agents/skills/project-boarding-guide/scripts/check-onboarding.sh
ถ้ารัน script ไม่ได้ ให้ตรวจเอง:
package.json.env.exampleprisma/schema.jsonDockerfilenext.config.ts
สำหรับ onboarding ทั่วไป ให้แนะนำเฉพาะคำสั่งเหล่านี้ที่ปลอดภัย:
npm install
cp .env.example .env
npx prisma generate
npm run lint
npm run dev
ถ้า user ถามเรื่อง database setup หรือ seed data โดยตรง ให้อ่านไฟล์นี้ references/database-setup.md
ข้อควรระวังของโปรเจกต์
อ่านรายละเอียดเพิ่มที่ references/project-notes.md
- Next.js App Router + TypeScript
- Prisma ใช้ custom output ไปที่
generated/prisma - Prisma Client import จาก generated path ไม่ใช่
@prisma/client - Dockerfile อาจใช้
.next/standalone; ต้องมีoutput: "standalone"ในnext.config.ts - UI หลักเป็นภาษาไทย
รูปแบบผลลัพธ์
ถ้าถามเกี่ยวกับ setup หรือตั้งค่าโปรเจกต์ ให้ใช้ template ใน assets/templates/setup-table.md เท่านั้น
ต้องมีอย่างน้อย:
- ภาพรวมสั้น ๆ
- ตารางขั้นตอน setup
- คำสั่งที่ต้องรัน
- ข้อควรระวังของ repo นี้