Aller au contenu
Premiers pas

Comment rédiger une bonne demande

Ce qu'il faut inclure dans une demande à Codexe, avec de bons et de mauvais exemples pour les plugins, les mods, les datapacks, les bots et les sites web.

Mis à jour

Sur cette page
  1. Ce qu'il faut inclure
  2. Mauvais ou meilleur
  3. Gros projets : avancez par étapes
  4. Améliorer le prompt
  5. Dites ce que vous ne voulez pas

La demande est le facteur qui pèse le plus sur la qualité du résultat. L'IA ne peut créer que ce qu'elle parvient à déduire : une demande précise vaut mieux qu'une demande longue.

#Ce qu'il faut inclure

  • Plateforme et version. « Paper 1.21.4 », « Fabric pour 1.20.1 », « datapack pour 1.21.1 », « discord.py ».
  • Comportement. Ce qui se passe, étape par étape, y compris ce qui se passe quand quelque chose tourne mal.
  • Commandes et arguments. /home <name>, qui peut les exécuter, et les messages affichés.
  • Permissions. Les noms des nœuds et leurs valeurs par défaut.
  • Configuration. Ce que les propriétaires de serveur doivent pouvoir modifier.
  • Stockage. En mémoire, dans un fichier YAML, SQLite ou MySQL, et si les données survivent aux redémarrages.
  • Intégrations. Vault, PlaceholderAPI, LuckPerms, WorldGuard. Nommez-les explicitement.
  • Interface. Messages dans le chat, GUI (menus d'inventaire), scoreboards, barres de boss.
  • Cas limites. Joueurs hors ligne, inventaires pleins, mondes désactivés, rechargements.

#Mauvais ou meilleur

Mauvais : make a factions plugin

Meilleur :

Text
A Paper 1.21.x factions plugin.
- /f create <name>, /f invite <player>, /f join <name>, /f leave, /f disband (owner only).
- Max 10 members per faction (configurable).
- Chunk claiming with /f claim and /f unclaim; claimed chunks block building by non-members.
- Faction power: +1 per online member, claims limited to power x 2.
- Data saved to SQLite, loaded on startup.
- Vault economy: creating a faction costs 1000 (configurable).
- Permissions: factions.use (default true), factions.admin (op) for /f admin bypass.

Mauvais : a mod with new swords

Meilleur :

Text
A Fabric mod for Minecraft 1.20.1.
- Adds three swords: Ember Blade (sets targets on fire for 3s), Frost Edge (Slowness II for 2s), Void Cutter (5% chance to teleport the target 8 blocks).
- Crafting recipes using blaze rods, packed ice and ender pearls with a netherite sword.
- English lang file and item models (textures can be placeholders).
- No client-only code on the server side.

Mauvais : custom recipes

Meilleur :

Text
A datapack for Minecraft 1.21.1.
- Shaped recipe: 8 rotten flesh around a leather = 1 leather.
- Shapeless recipe: 9 nether wart = 1 nether wart block, and the reverse.
- A function that runs every tick and gives Speed I to players standing on gold blocks.

Mauvais : moderation bot

Meilleur :

Text
A discord.py bot with slash commands.
- /warn <user> <reason>: stores warnings in SQLite, DMs the user.
- /warnings <user>: lists warnings with dates.
- /timeout <user> <minutes> <reason>: applies a Discord timeout; only for members with Moderate Members.
- Logs every action to a channel set with /setlog.
- Token read from an environment variable.

#Gros projets : avancez par étapes

Ne collez pas un cahier des charges de cinquante fonctionnalités dans une seule demande. Commencez par le cœur (modèle de données, commandes principales), laissez Codexe le vérifier, puis ajoutez des fonctionnalités dans des messages de suivi. Chaque étape est plus petite, moins chère, vérifiée et plus facile à corriger.

#Améliorer le prompt

Sur Créer (Créer un projet), le bouton Améliorer le prompt réécrit une demande sommaire en une demande plus complète. Il coûte un forfait de 5,000 tokens. Lisez toujours le texte amélioré avant de générer : il peut supposer des détails dont vous ne voulez pas.

#Dites ce que vous ne voulez pas

« Pas de base de données, tout dans config.yml », « n'utilise pas NMS », « aucune dépendance externe ». Les contraintes empêchent l'IA de choisir quelque chose que vous ne pouvez pas utiliser.

Comment rédiger une bonne demande | Codexe Docs