Communitygithub.com

chandrapratamalab/phantom-skill

Générez un document complet d'exigences produit et techniques (PRD-Project) avec des diagrammes Mermaid visuels via un processus interactif en deux étapes. Utilisez-le lorsque l'utilisateur demande de créer un PRD, de planifier un projet logiciel/web/mobile/IA/jeu, de rédiger des spécifications ou de concevoir une architecture système.

Qu'est-ce que phantom-skill ?

Cette compétence transforme toute idée de projet en un document d'exigences produit et techniques (PRD) complet et prêt pour le développement. Elle fonctionne via un flux de travail interactif en deux étapes : d'abord, l'assistant pose 4 à 5 questions dynamiques et pertinentes pour cerner la nature du projet (site 3D/mouvement, SaaS, application mobile, agent IA, jeu, etc.) et ses contraintes. Ensuite, il génère un `PRD.md` structuré en 7 sections (Aperçu, Exigences, Fonctionnalités principales, Parcours utilisateur, Architecture, Schéma de base de données et Stack technologique), avec des diagrammes Mermaid valides intégrés. Cette compétence est conçue pour les agents d'IA comme Claude Code, Cursor, Codex ou tout assistant de codage, et garantit des spécifications concrètes, exploitables et exemptes de verbiage inutile, idéales pour une implémentation directe par des développeurs ou des agents d'IA de codage. Elle prend en charge les projets backend, frontend, 3D, CLI et outils, en adaptant dynamiquement le contenu technique, y compris le schéma de base de données (ERD ou état local selon le type de projet).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/chandrapratamalab/phantom-skill/tree/HEAD/skills/prd-writer

Demander à votre IA préférée

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

Documentation

Rédacteur Universel de PRD

Transformez toute idée de projet en un document complet et prêt pour le développement, intitulé PRD.md (Document d'exigences produit et techniques).

Flux de travail

Étape 1 : Analyser la demande et poser des questions de clarification dynamiques

NE générez PAS le PRD complet dès le premier tour sauf si l'utilisateur dit explicitement « fais-le directement » / « ignore les questions » ou a déjà fourni des détails complets.

  1. Détecter la nature du projet : Identifiez ce que l'utilisateur construit à partir de sa demande (par exemple, site 3D/mouvement, SaaS/application web, application mobile, agent IA/robot, jeu, CLI/plugin ou système d'entreprise).
  2. Poser 4 à 5 questions hyper-pertinentes : Formulez des questions strictement adaptées au domaine spécifique de ce projet :
    • Interrogez sur l'objectif principal/utilisateur cible et l'action finale attendue.
    • Interrogez sur les mécaniques spécifiques au domaine (par exemple, interactions 3D/scroll pour une page de mouvement ; rôles utilisateur et flux de paiement pour un SaaS ; déclencheur/flux API pour un robot ; boucle de jeu pour un jeu).
    • Interrogez sur les limites du périmètre MVP et les préférences techniques/bibliothèques ou contraintes matérielles.
  3. Fournir des exemples rapides : Incluez des options courtes entre parenthèses après chaque question pour que l'utilisateur puisse répondre rapidement, et rappelez-lui : « Répondez aux points déjà dans votre esprit, ou tapez 'fais-le directement' pour que je choisisse automatiquement la meilleure option. »

Étape 2 : Générer le PRD-Project en 7 sections

Une fois que l'utilisateur a répondu (ou demande à procéder immédiatement), enregistrez la sortie dans PRD.md (si dans un espace de travail de code) et présentez le document en suivant cette structure exacte en 7 sections, en adaptant dynamiquement le contenu technique au type de projet :

# PRD-Project : [Nom du projet]
## Document d'exigences

### 1. Aperçu
- **Résumé du produit :** Concept, problème principal résolu et proposition de valeur unique.
- **Public cible et personas :** Rôles utilisateur, objectifs et points douloureux.
- **Objectifs et indicateurs de succès :** KPI mesurables adaptés au projet (par exemple, taux de conversion, FPS/vitesse de chargement, rétention ou précision des tâches).

### 2. Exigences
- **Exigences fonctionnelles :** Capacités principales regroupées logiquement par rôle, module ou section d'écran.
- **Exigences non fonctionnelles :** Références de performance, réactivité, sécurité, compatibilité et limites de ressources.
- **Hors périmètre (Phase 1) :** Fonctionnalités intentionnellement exclues de la version initiale.

### 3. Fonctionnalités principales
Pour chaque fonctionnalité/module, spécifiez :
- **Priorité :** P0 (Indispensable), P1 (Souhaitable), P2 (Agréable à avoir).
- **Récit utilisateur :** En tant que [rôle], je veux [action], afin de [bénéfice].
- **Critères d'acceptation :** Conditions de réussite/échec concrètes et testables.
- **Cas limites et solutions de repli :** Gestion des erreurs, états vides, appareils faibles/navigateurs non pris en charge ou requêtes échouées.

### 4. Parcours utilisateur
- **Parcours étape par étape :** Chemin d'interaction utilisateur ou système chronologique du début à la fin.
- **Diagramme de flux visuel :** Rendre un diagramme `mermaid` propre (`flowchart TD` ou `sequenceDiagram`).

### 5. Architecture
- **Structure système et dossiers :** Interaction des composants de haut niveau et disposition de répertoire recommandée.
- **Diagramme d'architecture :** Rendre un diagramme `mermaid` montrant comment l'interface utilisateur, la logique, les API, les boucles de rendu ou les services externes se connectent.
- **Modules/points de terminaison principaux :** Tableau des routes, contrôleurs ou gestionnaires d'événements clés.

### 6. Schéma de base de données (Adaptatif au type de projet)
- **Si backend/application persistante :** Fournissez un `erDiagram` Mermaid et les schémas de table (champs, types, contraintes PK/FK, relations).
- **Si frontend uniquement/statique/3D/CLI/outil :** Définissez le schéma d'état local, la structure JSON de configuration, le manifeste des actifs ou le schéma de charge utile du formulaire/événement au lieu de tables SQL.

### 7. Stack technologique
Recommandez les outils optimaux avec de brèves justifications adaptées aux contraintes de l'utilisateur (Frontend/UI, Logique/Backend, Données/Actifs, Déploiement).

Règles de diagramme et de qualité

  • Mermaid valide uniquement : Encapsulez toujours les étiquettes de nœud contenant des espaces, parenthèses ou symboles entre guillemets doubles (par exemple, A["Section Hero (Vue 3D)"] --> B["Déclencheur de défilement"]) pour que les diagrammes s'affichent proprement sans erreurs de syntaxe.
  • Zéro remplissage : Gardez les spécifications concrètes, exploitables et prêtes pour une implémentation directe par les développeurs ou les agents d'IA de codage.

Skills associés