Preskočiť na obsah
Začíname

Ako napísať dobrú požiadavku

Čo zahrnúť do požiadavky pre Codexe, s dobrými a zlými príkladmi pre pluginy, mody, datapacky, boty a webové stránky.

Aktualizované

Na tejto stránke
  1. Čo zahrnúť
  2. Zlé vs. lepšie
  3. Veľké projekty: stavaj po krokoch
  4. Vylepšiť zadanie
  5. Povedz, čo nechceš

Požiadavka je najväčší samostatný faktor, ktorý ovplyvňuje kvalitu výsledku. AI dokáže vytvoriť len to, čo si vie odvodiť, takže konkrétne požiadavky porazia dlhé.

#Čo zahrnúť

  • Platformu a verziu. „Paper 1.21.4“, „Fabric pre 1.20.1“, „datapack pre 1.21.1“, „discord.py“.
  • Správanie. Čo sa deje, krok za krokom, vrátane toho, čo sa stane, keď sa niečo pokazí.
  • Príkazy a argumenty. /home <name>, kto ich môže spúšťať a aké správy sa zobrazia.
  • Oprávnenia. Názvy uzlov a predvolené hodnoty.
  • Konfiguráciu. Čo by majitelia serverov mali môcť meniť.
  • Ukladanie. V pamäti, v súbore YAML, v SQLite alebo MySQL a či prežije reštarty.
  • Integrácie. Vault, PlaceholderAPI, LuckPerms, WorldGuard. Pomenuj ich výslovne.
  • Rozhranie. Správy v chate, GUI (menu v inventári), scoreboardy, boss bary.
  • Hraničné prípady. Offline hráči, plné inventáre, vypnuté svety, reloady.

#Zlé vs. lepšie

Zlé: make a factions plugin

Lepšie:

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.

Zlé: a mod with new swords

Lepšie:

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.

Zlé: custom recipes

Lepšie:

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.

Zlé: moderation bot

Lepšie:

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.

#Veľké projekty: stavaj po krokoch

Nevkladaj do jednej požiadavky špecifikáciu s päťdesiatimi funkciami. Začni jadrom (dátový model, hlavné príkazy), nechaj Codexe ho overiť a potom pridávaj funkcie v ďalších správach. Každý krok je menší, lacnejší, overený a ľahšie sa opravuje.

#Vylepšiť zadanie

Na stránke Vytvoriť (Vytvorenie projektu) tlačidlo Vylepšiť zadanie prepíše hrubú požiadavku na úplnejšiu. Stojí paušálne 5,000 tokenov. Vylepšený text si pred generovaním vždy prečítaj: môže predpokladať detaily, ktoré nechceš.

#Povedz, čo nechceš

„Žiadna databáza, všetko drž v config.yml“, „nepoužívaj NMS“, „žiadne externé závislosti“. Obmedzenia zabránia AI, aby zvolila niečo, čo nemôžeš použiť.

Ako napísať dobrú požiadavku | Codexe Docs