Exigences de Survie Extrême
Utilisez ce skill pour produire des exigences fonctionnelles durables pour 《末日余生:极限生存》. Le résultat doit aider deux lecteurs :
- Lecteur Codex / développeur : suffisamment de détails pour continuer l'implémentation dans une nouvelle fenêtre.
- Lecteur propriétaire de projet humain : des exigences claires et en langage simple, faciles à relire et à corriger.
Ce skill ne produit que des exigences fonctionnelles. N'incluez pas de plannings, de semaines de développement, de dates, de plans de sprint, de prévisions de lancement, de plans de personnel ni d'estimations budgétaires.
Barre de qualité non négociable
Ne produisez pas une simple liste de fonctionnalités. Chaque fonctionnalité centrale doit être développée suffisamment pour permettre l'implémentation et la relecture. Pour les exigences destinées à l'IA, chaque fonctionnalité doit inclure :
- Identifiant d'exigence stable.
- Nom du module et de la fonctionnalité.
- Explication en une ligne destinée au propriétaire.
- Objectif et user story.
- Préconditions.
- Flux principal.
- Flux de branche/exception.
- Règles et limites.
- Champs d'état/données.
- Champs de configuration.
- Éléments d'interface/feedback.
- Gestion des erreurs.
- Séparation de l'implémentation en deux versions :
- logique partagée,
- version maître Game Studio / Phaser,
- adaptation WeChat Mini Game.
- Critères d'acceptation.
- Suggestions de tests.
- Non-objectifs explicites.
- Questions ouvertes.
Pour les exigences lisibles par le propriétaire, chaque fonctionnalité doit expliquer :
- Ce que fait la fonctionnalité.
- Comment le joueur l'utilise.
- À quoi ressemble le fonctionnement normal.
- Ce qui peut échouer.
- Quelles règles doivent être suivies.
- Ce que le joueur voit.
- Ce qui compte comme terminé.
- Ce qui est temporairement exclu.
- Ce que le propriétaire du projet doit confirmer.
Si la sortie semble plus courte ou moins détaillée que le plan de développement du projet, enrichissez-la avant de la livrer.
Stratégie de projet centrale
Préservez toujours cette stratégie sauf si l'utilisateur la modifie explicitement :
- Construisez d'abord le gameplay dans une version maître navigateur Game Studio + Phaser/TypeScript.
- Convertissez ou migrez les fonctionnalités stables dans une version d'adaptation WeChat Mini Game séparée.
- Conservez les deux versions de code :
Game Studio / Phaser master: itération rapide du gameplay, test en navigateur, débogage, validation des fonctionnalités.WeChat Mini Game adaptation: pont d'exécution WeChat, tactile/cycle de vie/ressources/connexion/adaptation, vérification sur simulateur et appareil réel, publication.
- Ne laissez pas le travail d'exécution spécifique à WeChat polluer la logique de gameplay indépendante de la plateforme.
Sorties standard
Lorsque l'utilisateur demande de générer des exigences pour ce projet, créez un ou les deux fichiers suivants :
ai-functional-requirements.md: orienté implémentation, précis, structuré et adapté à un transfert à Codex.reader-functional-requirements.md: lisible par un humain, en chinois simple, axé sur ce que le joueur voit et ce que le propriétaire du projet peut approuver.
Si l'utilisateur demande des documents Word, créez des versions .docx à partir du même contenu en utilisant le skill Documents.
Flux de travail
- Inspectez d'abord les artefacts existants du projet :
- PRD/documents existants dans
deliverables/; - code source actuel Game Studio/Phaser ;
- code source actuel WeChat Mini Game ;
- journaux de problèmes/solutions s'ils sont présents.
- PRD/documents existants dans
- Extrayez uniquement les exigences fonctionnelles et les contraintes du projet. Ignorez les plannings et les dates.
- Construisez un inventaire des fonctionnalités avant d'écrire le texte.
- Générez d'abord la spécification destinée à l'IA.
- Générez le document lisible par le propriétaire à partir du même inventaire d'exigences.
- Validez la paire :
- pas de langage de planning/calendrier ;
- les deux documents décrivent le même ensemble de fonctionnalités ;
- la stratégie double version est explicite ;
- chaque fonctionnalité centrale a des règles, des flux, des erreurs, des données/config, des critères d'acceptation et des questions ouvertes ;
- les questions ouvertes sont clairement marquées au lieu d'être devinées.
Conventions d'identifiants d'exigences
Utilisez des identifiants stables pour que les documents, le code, les tests et les problèmes ultérieurs puissent référencer la même fonctionnalité :
ES-FR-META-*: limites du projet et règles inter-versions.ES-FR-CORE-*: boucle centrale, flux de match, règlement.ES-FR-PLAYER-*: déplacement du joueur, contrôles, interaction, état, mort, réapparition.ES-FR-MAP-*: carte, caméra, collision, zone de sécurité, points d'intérêt.ES-FR-ZOMBIE-*: apparition d'ennemis/zombies, IA, combat.ES-FR-SURVIVAL-*: santé, faim, soif, endurance, infection.ES-FR-ITEM-*: butin, inventaire, ramassage, dépôt, utilisation.ES-FR-CRAFT-*: artisanat.ES-FR-BUILD-*: construction et placement.ES-FR-COMBAT-*: armes, attaques, détection de coup, dégâts, feedback.ES-FR-NET-*: matchmaking, salles, synchronisation, reconnexion.ES-FR-WECHAT-*: connexion WeChat, cycle de vie, ressources, publicités, classement, conformité.ES-FR-UI-*: HUD, menus, invites, résultats.ES-FR-DATA-*: sauvegarde, configuration, télémétrie, enregistrements backend.ES-NFR-*: exigences non fonctionnelles telles que performance, compatibilité, sécurité, maintenabilité.
Script utile
Utilisez scripts/generate_requirements.py pour générer la paire détaillée en Markdown. Préférez l'exécuter depuis la racine du projet en passant --project-root . afin que les chemins Windows non ASCII ne soient pas altérés par l'encodage du shell :
python extreme-survival-requirements/scripts/generate_requirements.py --project-root . --out-dir deliverables/requirements
Le script inclut une protection contre les termes de planning et échouera s'il détecte des termes courants de type planning.
À ne pas inclure
- Cycles de développement, plans hebdomadaires, dates, prévisions de version ou estimations de personnel.
- Garanties de revenus ou garanties d'approbation de plateforme.
- Chaîne de pensée cachée, informations d'identification privées, AppSecret, jetons ou identifiants personnels.
- Exigences qui contredisent la stratégie double version Game Studio → WeChat Mini Game, sauf si l'utilisateur change explicitement de direction.