thanatornPik/nextjs-skill-app-workshop

Utilisez cette compétence lorsqu'un développeur demande comment configurer, exécuter ou comprendre ce projet Next.js. Idéale pour les questions d'intégration (onboarding) telles que « Comment configurer ce projet ? », « Comment le lancer ? », « Quelle stack est utilisée ? » ou les questions sur Docker/Prisma de la part d'une personne novice dans le codebase.

Qu'est-ce que nextjs-skill-app-workshop ?

Cette compétence (skill) est conçue pour assister les développeurs lors de leur intégration dans un projet Next.js utilisant App Router, TypeScript, Prisma et Docker. Elle fournit des instructions étape par étape pour cloner, configurer et exécuter le projet localement en toute sécurité, en évitant les commandes destructrices pour la base de données. Elle s'appuie sur des fichiers réels du dépôt (package.json, .env.example, Prisma schema, etc.) et inclut des vérifications via un script shell. La compétence est utile pour les plateformes d'IA agent (Claude Code, Cursor, Codex) et guide l'utilisateur vers les commandes sûres, les fichiers de référence (comme database-setup.md) et les templates de sortie. Elle met en garde contre les pièges courants : import Prisma depuis un chemin personnalisé, nécessité du mode standalone dans next.config.ts, et interface utilisateur en thaï.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thanatornPik/nextjs-skill-app-workshop/tree/HEAD/.agents/skills/project-onboarding-guide

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compétence d'Intégration au Projet

Aide le nouveau développeur à comprendre ce projet, du clonage à l'exécution locale, en se référant aux fichiers réels du dépôt avant de répondre.

Points d'attention

  • Ne pas deviner de script qui n'existe pas dans package.json
  • Ne pas utiliser de commandes destructrices pour la base de données pendant l'intégration, comme npx prisma db push, npx prisma migrate deploy, npx prisma migrate dev
  • Si Docker est mentionné, vérifier à la fois le Dockerfile et next.config.ts

Étapes de configuration

Vérifier et exécuter d'abord ce script : .agents/skills/project-boarding-guide/scripts/check-onboarding.sh Si le script ne peut pas être exécuté, vérifier manuellement :

  • package.json
  • .env.example
  • prisma/schema.json
  • Dockerfile
  • next.config.ts

Pour une intégration générale, recommander uniquement ces commandes sûres :

npm install
cp .env.example .env
npx prisma generate
npm run lint
npm run dev

Si l'utilisateur pose des questions sur la configuration de la base de données ou les données de seed, lire ce fichier : references/database-setup.md

Points d'attention du projet

Lire les détails supplémentaires dans references/project-notes.md

  • Next.js App Router + TypeScript
  • Prisma utilise une sortie personnalisée vers generated/prisma
  • L'import du client Prisma se fait depuis ce chemin généré, pas depuis @prisma/client
  • Le Dockerfile peut utiliser .next/standalone ; output: "standalone" doit être présent dans next.config.ts
  • L'interface utilisateur principale est en thaï

Format de sortie

Si la question concerne la configuration ou la mise en place du projet, utiliser uniquement le template dans assets/templates/setup-table.md

Doit contenir au minimum :

  • Un résumé court
  • Un tableau des étapes de configuration
  • Les commandes à exécuter
  • Les précautions à prendre pour ce dépôt

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills associés